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Kapitel 3 
Klassen und Objekte 


»Nichts auf der Welt ist so gerecht verteilt wie der Verstand. Denn jedermann 
ist davon überzeugt, dass er genug davon habe.« 
— Rene Descartes (1596-1650) 


3.1 Objektorientierte Programmierung (OOP) 


In einem Buch über Java-Programmierung müssen mehrere Teile vereinigt werden: 


> 


> 


zunächst die grundsätzliche Programmierung nach dem imperativen Prinzip (Variablen, 
Operatoren Fallunterscheidung, Schleifen, einfache statische Methoden) in einer neuen 
Grammatik für Java, 


dann die Objektorientierung (Objekte, Klassen, Vererbung, Schnittstellen), erweiterte 
Möglichkeiten der Java-Sprache (Ausnahmen, Generics, Lambda-Ausdrücke) und zum 
Schluss 


die Bibliotheken (String-Verarbeitung, Ein-/Ausgabe ...). 


Dieses Kapitel stellt das Paradigma der Objektorientierung in den Mittelpunkt und zeigt die 
Syntax, wie etwa in Java Klassen realisiert werden und Klassen-/Objektvariablen sowie 
Methoden eingesetzt werden. 


Hinweis 

Java ist natürlich nicht die erste objektorientierte Sprache (OO-Sprache), auch C++ war nicht 
die erste. Klassischerweise gelten Smalltalk und insbesondere Simula-67 aus dem Jahr 1967 
als Stammväter aller OO-Sprachen. Die eingeführten Konzepte sind bis heute aktuell, darun- 
ter die vier allgemein anerkannten Prinzipien der OOP: Abstraktion, Kapselung, Vererbung und 
Polymorphie.' 


3.1.1 Warum überhaupt OOP? 


Da Menschen die Welt in Objekten wahrnehmen, wird auch die Analyse von Systemen häufig 
schon objektorientiert modelliert. Doch mit prozeduralen Systemen, die lediglich Unterpro- 


1 Keine Sorge, alle vier Grundsäulen werden in den nächsten Kapiteln ausführlich beschrieben! 
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gramme als Ausdrucksmittel haben, wird die Abbildung des objektorientierten Designs in 
eine Programmiersprache schwer, und es entsteht ein Bruch. Im Laufe der Zeit entwickeln 
sich Dokumentation und Implementierung auseinander; die Software ist dann schwer zu 
warten und zu erweitern. Besser ist es, objektorientiert zu denken und dann eine objekt- 
orientierte Programmiersprache zur Abbildung zu haben. 


Hinweis 


Bad code can be written in any language. 


Identität, Zustand, Verhalten 

Die in der Software abgebildeten Objekte haben drei wichtige Eigenschaften: 
> Jedes Objekt hat eine Identität. 

>» Jedes Objekt hat einen Zustand. 

> Jedes Objekt zeigt ein Verhalten. 


Diese drei Eigenschaften haben wichtige Konsequenzen: zum einen, dass die Identität des 
Objekts während seines Lebens bis zu seinem Tod dieselbe bleibt und sich nicht ändern kann. 
Zum anderen werden die Daten und der Programmcode zur Manipulation dieser Daten als 
zusammengehörig behandelt. In prozeduralen Systemen finden sich oft Szenarien wie das 
folgende: Es gibt einen großen Speicherbereich, auf den alle Unterprogramme irgendwie 
zugreifen können. Bei den Objekten ist das anders, da sie logisch ihre eigenen Daten verwal- 
ten und die Manipulation überwachen. 


In der objektorientierten Softwareentwicklung geht es also darum, in Objekten zu modellie- 
ren und dann zu programmieren. Das Design nimmt dabei eine zentrale Stellung ein; große 
Systeme werden zerlegt und immer feiner beschrieben. Hier passt sehr gut die Aussage des 
französischen Schriftstellers Francois Duc de La Rochefoucauld (1613-1680): 


»Wer sich zu viel mit dem Kleinen abgibt, wird unfähig für Großes.« 


3.1.2 Denk ich an Java, denk ich an Wiederverwendbarkeit 


Bei jedem neuen Projekt fällt auf, dass in früheren Projekten schon ähnliche Probleme gelöst 
werden mussten. Natürlich sollen bereits gelöste Probleme nicht neu implementiert, son- 
dern sich wiederholende Teile bestmöglich in unterschiedlichen Kontexten wiederverwen- 
det werden; das Ziel ist die bestmögliche Wiederverwendung von Komponenten. 


Wiederverwendbarkeit von Programmteilen gibt es nicht erst seit den objektorientierten 
Programmiersprachen, objektorientierte Programmiersprachen erleichtern aber die Pro- 


3.2 Eigenschaften einer Klasse 


grammierung wiederverwendbarer Softwarekomponenten. So sind auch die vielen Tau- 
send Klassen der Bibliothek ein Beispiel dafür, dass sich Entwickler nicht ständig um die 
Umsetzung etwa von Datenstrukturen oder um die Pufferung von Datenströmen küm- 
mern müssen. 


Auch wenn Java eine objektorientierte Programmiersprache ist, ist das kein Garant für tolles 
Design und optimale Wiederverwendbarkeit. Eine objektorientierte Programmiersprache 
erleichtert objektorientiertes Programmieren, aber auch in einer einfachen Programmier- 
sprache wie C lässt sich objektorientiert programmieren. In Java sind auch Programme mög- 
lich, die aus nur einer Klasse bestehen und dort 5.000 Zeilen Programmcode mit statischen 
Methoden unterbringen. Bjarne Stroustrup (der Schöpfer von C++, von seinen Freunden 
auch Stumpy genannt) sagte treffend über den Vergleich von C und C++: 


»C makes it easy to shoot yourself in the foot, C++ makes it harder, but when you do, it 
blows away your whole leg.«? 


Im Sinne unserer didaktischen Vorgehensweise wird dieses Kapitel zunächst einige Klassen 
der Standardbibliothek verwenden. Wir beginnen mit der Klasse Point, die zweidimensio- 
nale Punkte repräsentiert. In einem zweiten Schritt werden wir eigene Klassen programmie- 
ren. Anschließend kümmern wir uns um das Konzept der Abstraktion in Java, nämlich 
darum, wie Gruppen zusammenhängender Klassen gestaltet werden. 


3.2 Eigenschaften einer Klasse 


Klassen sind ein wichtiges Merkmal objektorientierter Programmiersprachen. Eine Klasse 
definiert einen neuen Typ, beschreibt die Eigenschaften der Objekte und gibt somit den Bau- 
plan an. 


Jedes Objekt ist ein Exemplar (auch Instanz? oder Ausprägung genannt) einer Klasse. 

Eine Klasse deklariert im Wesentlichen zwei Dinge: 

> Attribute (was das Objekt hat) 

> Operationen (was das Objekt kann) 

Attribute und Operationen heißen auch Eigenschaften eines Objekts; einige Autoren nennen 
allerdings nur Attribute Eigenschaften. Welche Eigenschaften eine Klasse tatsächlich besit- 


zen soll, wird in der Analyse- und Designphase festgesetzt. Diese wird in diesem Buch kein 
Thema sein; für uns liegen die Klassenbeschreibungen schon vor. 


2 Oder wie es Bertrand Meyer sagt: »Do not replace legacy software by lega-c++ software.« 

3 Ich vermeide das Wort Instanz und verwende dafür durchgängig das Wort Exemplar. An die Stelle von 
instanziieren tritt das einfache Wort erzeugen. Instanz ist eine irreführende Übersetzung des englischen 
Ausdrucks »instance«. 
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Die Operationen einer Klasse setzt die Programmiersprache Java durch Methoden um. Die 
Attribute eines Objekts definieren die Zustände, und sie werden durch Klassen-/Objektvaria- 
blen implementiert (die auch Felder* genannt werden). 


Hinweis 

Im Begriff »objektorientierte Programmierung« taucht zwar der Begriff »Objekt« auf, aber 
nicht der Begriff »Klasse«, den wir auch schon oft verwendet haben. Warum heißt es also 
nicht stattdessen »klassenbasierte Programmierung«? Der Grund ist, dass Klassendeklaratio- 
nen für objektorientierte Programme nicht zwingend nötig sind. Ein anderer Ansatz ist die 
prototypbasierte objektorientierte Programmierung. Hier ist JavaScript der bekannteste Ver- 
treter; dabei gibt es nur Objekte, und die sind mit einer Art Basistyp, dem Prototyp, verkettet. 


Um sich einer Klasse zu nähern, können wir einen lustigen Ich-Ansatz (Objektansatz) verwen- 
den, der auch in der Analyse- und Designphase eingesetzt wird. Bei diesem Ich-Ansatz verset- 
zen wir uns in das Objekt und sagen »Ich bin ...« für die Klasse, »Ich habe ...« für die Attribute 
und »Ich kann ...« für die Operationen. Meine Leser sollten dies bitte an den Klassen Mensch, 
Auto, Wurm und Kuchen testen. 


3.2.1 Klassenarbeit mit Point 


Bevor wir uns mit eigenen Klassen beschäftigen, wollen wir zunächst einige Klassen aus der 
Standardbibliothek kennenlernen. Eine einfache Klasse ist Point. Sie beschreibt durch die 
Koordinaten x und y einen Punkt in einer zweidimensionalen Ebene und bietet einige Ope- 
rationen an, mit denen sich Punkt-Objekte verändern lassen. Testen wir einen Punkt wieder 
mit dem Objektansatz: 


Begriff Erklärung 
Klassenname Ich bin ein Punkt. 
Attribute Ich habe eine x- und y-Koordinate. 


Operationen Ich kann mich verschieben und meine Position festlegen. 


Tabelle 3.1 OOP-Begriffe und was sie bedeuten 


Zu unserem Punkt können wir in der API-Dokumentation (https://docs.oracle.com/en/java/ 
Javase/17/docs/api/java.desktop/java/awt/Point.html) von Oracle nachlesen, dass er die 
Objektvariablen x und y definiert, unter anderem eine Methode setlocation(..) besitzt und 
einen Konstruktor anbietet, der zwei Ganzzahlen annimmt. 


4 Den Begriff Feld benutze ich im Folgenden nicht. Er bleibt für Arrays reserviert. 
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3.3 Natürlich modellieren mit der UML (Unified Modeling Language) * 


Für die Darstellung einer Klasse lässt sich Programmcode verwenden, also eine Textform, 
oder aber eine grafische Notation. Eine dieser grafischen Beschreibungsformen ist die UML. 
Grafische Abbildungen sind für Menschen deutlich besser zu verstehen und erhöhen die 
Übersicht. 


Im ersten Abschnitt eines UML-Diagramms lassen sich die Attribute ablesen, im zweiten die 
Operationen. Das + vor den Eigenschaften (siehe Abbildung 3.1) zeigt an, dass sie öffentlich 
sind und jeder sie nutzen kann. Die Typangabe ist gegenüber Java umgekehrt: Zuerst kommt 
der Name der Variablen, dann der Typ bzw. bei Methoden der Typ des Rückgabewerts. Andere 
Programmiersprachen wie TypeScript oder Kotlin nutzen auch diese »umgedrehte« Typ- 
angabe im Code. 


java::awt::Point 


x : int 
y : int 


Point() 

Point(p : Point) 

Point(x : int, y : int) 

getX() : double 

getY() : double 

getLocation() : Point 
setLocation(p : Point) 
setLocation(x : int, y : int) 
setLocation(x : double, y : double) 
move(x : int, y : int) 
translate(dx : int, dy : int) 
equals(obj : Object) : boolean 
toString() : String 


Abbildung 3.1 Die Klasse »java.awt.Point« in der UML-Darstellung 


3.3.1 Wichtige Diagrammtypen der UML* 


Die UML definiert diverse Diagrammtypen, die unterschiedliche Sichten auf die Software 
beschreiben können. Für die einzelnen Phasen im Softwareentwurf sind jeweils andere Dia- 
gramme wichtig. Wir wollen kurz vier Diagramme und ihr Einsatzgebiet besprechen. 


Anwendungsfalldiagramm 


Ein Anwendungsfalldiagramm (Use-Cases-Diagramm) entsteht meist während der Anforde- 
rungsphase und beschreibt die Geschäftsprozesse, indem es die Interaktion von Personen - 
oder von bereits existierenden Programmen - mit dem System darstellt. Die handelnden 
Personen oder aktiven Systeme werden Aktoren genannt und sind im Diagramm als kleine 
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(geschlechtslose) Männchen angedeutet. Anwendungsfälle (Use Cases) beschreiben dann 
eine Interaktion mit dem System. 


Klassendiagramm 

Für die statische Ansicht eines Programmentwurfs ist das Klassendiagramm einer der wich- 
tigsten Diagrammtypen. Ein Klassendiagramm stellt zum einen die Elemente der Klasse dar, 
also die Attribute und Operationen, und zum anderen die Beziehungen der Klassen unterei- 
nander. Klassendiagramme werden in diesem Buch häufiger eingesetzt, um insbesondere 
die Assoziation und Vererbung zu anderen Klassen zu zeigen. Klassen werden in einem sol- 
chen Diagramm als Rechteck dargestellt, und die Beziehungen zwischen den Klassen werden 
durch Linien angedeutet. 


Objektdiagramm 


Ein Klassendiagramm und ein Objektdiagramm sind sich auf den ersten Blick sehr ähnlich. 
Der wesentliche Unterschied besteht darin, dass ein Objektdiagramm die Belegung der Attri- 
bute, also den Objektzustand, visualisiert. Dazu werden sogenannte Ausprägungsspezifikati- 
onen verwendet. Mit eingeschlossen sind die Beziehungen, die das Objekt zur Laufzeit mit 
anderen Objekten hält. Beschreibt zum Beispiel ein Klassendiagramm eine Person, so ist nur 
ein Rechteck im Diagramm. Hat diese Person zur Laufzeit Freunde (gibt es also Assoziationen 
zu anderen Personen-Objekten), so können sehr viele Personen in einem Objektdiagramm 
verbunden sein, während ein Klassendiagramm diese Ausprägung nicht darstellen kann. 


Sequenzdiagramm 


Das Sequenzdiagramm stellt das dynamische Verhalten von Objekten dar. So zeigt es an, in 
welcher Reihenfolge Operationen aufgerufen und wann neue Objekte erzeugt werden. Die 
einzelnen Objekte bekommen eine vertikale Lebenslinie, und horizontale Linien zwischen 
den Lebenslinien der Objekte beschreiben die Operationen oder Objekterzeugungen. Das 
Diagramm liest sich somit von oben nach unten. 


Da das Klassendiagramm und das Objektdiagramm eher die Struktur einer Software 
beschreiben, heißen die Modelle auch Strukturdiagramme (neben Paketdiagrammen, Kom- 
ponentendiagrammen, Kompositionsstrukturdiagrammen und Verteilungsdiagrammen). 
Ein Anwendungsfalldiagramm und ein Sequenzdiagramm zeigen eher das dynamische Ver- 
halten und werden Verhaltensdiagramme genannt. Weitere Verhaltensdiagramme sind das 
Zustandsdiagramm, das Aktivitätsdiagramm, das Interaktionsübersichtsdiagramm, das 
Kommunikationsdiagramm und das Zeitverlaufsdiagramm. In der UML ist es aber wichtig, 
die zentralen Aussagen des Systems in einem Diagramm festzuhalten, sodass sich problem- 
los Diagrammtypen mischen lassen. 


In diesem Buch kommen fast nur Klassendiagramme vor. 
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3.4 Neue Objekte erzeugen 


Eine Klasse beschreibt also, wie ein Objekt aussehen soll. In einer Mengen- bzw. Elementbe- 
ziehung ausgedrückt, entsprechen Objekte den Elementen und Klassen den Mengen, in 
denen die Objekte als Elemente enthalten sind. Diese Objekte haben Eigenschaften, die sich 
nutzen lassen. Wenn ein Punkt Koordinaten repräsentiert, wird es Möglichkeiten geben, 
diese Zustände zu erfragen und zu ändern. 


Im Folgenden wollen wir untersuchen, wie sich von der Klasse Point zur Laufzeit Exemplare 
erzeugen lassen und wie der Zugriff auf die Eigenschaften der Point-Objekte aussieht. 


3.4.1 Ein Exemplar einer Klasse mit dem Schlüsselwort new anlegen 


Objekte müssen in Java immer ausdrücklich erzeugt werden. Dazu definiert die Sprache das 
Schlüsselwort nen. 


Beispiel 
Anlegen eines Punkt-Objekts: 


new java.awt.Point(); 


Im Grunde ist new so etwas wie ein unärer Operator. Hinter dem Schlüsselwort new folgt der 
Name der Klasse, von der ein Exemplar erzeugt werden soll. Der Klassenname ist hier voll 
qualifiziert angegeben, da sich Point in einem Paket java.awt befindet. (Ein Paket ist eine 
Gruppe zusammengehöriger Klassen; wir werden in Abschnitt 3.6.3, »Volle Qualifizierung 
und import-Deklaration«, sehen, dass Entwickler diese Schreibweise auch abkürzen können.) 
Hinter dem Klassennamen folgt ein Paar runder Klammern für den Konstruktoraufruf. Die- 
ser ist eine Art Methodenaufruf, über den sich Werte für die Initialisierung des frischen 
Objekts übergeben lassen. 


Konnte die Speicherverwaltung von Java für das anzulegende Objekt freien Speicher reser- 
vieren und konnte der Konstruktor gültig durchlaufen werden, gibt der new-Ausdruck 
anschließend eine Referenz auf das frische Objekt an das Programm zurück. Merken wir uns 
diese Referenz nicht, kann die automatische Speicherbereinigung das Objekt wieder frei- 
geben. 


3.4.2 Deklarieren von Referenzvariablen 


Das Ergebnis eines new ist eine Referenz auf das neue Objekt. Die Referenz wird in der Regel 
in einer Referenzvariablen zwischengespeichert, um fortlaufende Eigenschaften des Objekts 
nutzen zu können. 
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Beispiel 
Deklariere die Variable p vom Typ java.awt.Point. Die Variable p nimmt anschließend die 
Referenz von dem neuen Objekt auf, das mit new angelegt wurde. 


java.awt.Point p; 
p = new java.awt.Point(); 


Die Deklaration und die Initialisierung einer Referenzvariablen lassen sich kombinieren 
(auch eine lokale Referenzvariable ist wie eine lokale Variable primitiven Typs zu Beginn un- 
initialisiert): 

java.awt.Point p = new java.awt.Point(); 


Die Typen müssen natürlich kompatibel sein, und ein Punkt-Objekt geht nicht als String 
durch. Der Versuch, ein Punkt-Objekt einer int- oder String-Variablen zuzuweisen, ergibt 
somit einen Compilerfehler: 


int p = new java.awt.Point(); // & Type mismatch: cannot convert from 
// Point to int 

String s = new java.awt.Point(); // kA Type mismatch: cannot convert from 
// Point to String 


Damit speichert eine Variable entweder einen einfachen Wert (Variable vom Typ int, boo- 
lean, double ...) oder einen Verweis auf ein Objekt. Der Verweis ist letztendlich intern ein Poin- 
ter auf einen Speicherbereich, doch der ist für Java-Entwickler so nicht sichtbar. 


Referenztypen gibt es in vier Ausführungen: Klassentypen, Schnittstellentypen (auch Inter- 
‚face-Typen genannt), Array-Typen (auch Feldtypen genannt) und Typvariablen (eine Spezia- 
lität von generischen Typen). In unserem Fall haben wir ein Beispiel für einen Klassentyp. 


new java.awt.Point(); 


aA = TR 
© Assign statement to new local variable (Ctrl+2, L) impor java awt Point: 


a Assign statement to new field (Ctrl+2, F public class T 
% Remove { 
® Return the allocated object = 
© Extract to local variable (replace all occurrences) Point point = new java.awt.Point(); 
© Extract to local variable 

@ Add @SuppressWarnings 'unused' to 'main()' 
© Extract to constant 


Press 'Tab' from proposal table or click for focus 


Abbildung 3.2 Die Tastenkombination [Strg )+[ 1] ermöglicht es, entweder eine neue lokale 
Variable oder eine Objektvariable für den Ausdruck anzulegen. 
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3.4.3 Jetzt mach mal ’nen Punkt: Zugriff auf Objektvariablen und -methoden 


Die in einer Klasse deklarierten Variablen heißen Objektvariablen bzw. Exemplar-, Instanz- 
oder Ausprägungsvariablen. Jedes erzeugte Objekt hat seinen eigenen Satz von Objektvaria- 
blen: Sie bilden den Zustand des Objekts. 


Der Punkt-Operator . erlaubt auf Objekten den Zugriff auf die Zustände oder den Aufrufvon 
Methoden. Der Punkt steht zwischen einem Ausdruck, der eine Referenz liefert, und der 
Objekteigenschaft. Welche Eigenschaften eine Klasse genau bietet, zeigt die API-Dokumenta- 
tion -wenn ein Objekt eine Eigenschaft nicht hat, wird der Compiler eine Nutzung verbieten. 


Beispiel 
Die Variable p referenziert ein java. awt.Point-Objekt. Die Objektvariablen x und y sollen ini- 


tialisiert werden: 


java.awt.Point p = new java.awt.Point(); 
p.x = 1; 
p.y = 2+0.X%; 


Ein Methodenaufruf gestaltet sich genauso einfach wie ein Zugriff auf Klassen- oder Objekt- 
variablen. Hinter dem Ausdruck mit der Referenz folgt nach dem Punkt der Methodenname. 


java.awt.Point p = new java.awt.Point(); 
| 
| Pa, 


er = The X coordinate of this Point. If no X coordinate is set it will default to 0. 
x: int - Point 


o y:int - Point 

© clone() : Object - Point2D 
© distance(Point2D pt) : double - Point2D getLocation() 
© distance(double px, double py) : double - Point2D è move(int, int) 
© distanceSq(Point2D pt) : double - Point2D Berta 

© distanceSq(double px, double py) : double - Point2D 
© equals(Object obj) : boolean - Point 

© getClass() : Class<?> - Object 

© getLocation() : Point - Point 

© getX() : double - Point 

© getY() : double - Po 

© hashCode() : int - Point2D 

© movelint x, int y) : void - Point 

© notify() : void - Object 
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Press 'Ctrl+Space' to show Template Proposals Press 'Tab' from proposal table or click for focus 


Abbildung 3.3 Die Tastenkombination + Leertaste zeigt an, welche Eigenschaften eine Refe- 
renz ermöglicht. Eine Auswahl mit der [+ ]-Taste wählt die Eigenschaft aus und setzt insbesondere 
bei Methoden den Cursor zwischen das Klammerpaar. 


5 Es gibt auch den Fall, dass sich mehrere Objekte eine Variable teilen, sogenannte statische Variablen. 
Diesen Fall werden wir später in Kapitel 6, »Eigene Klassen schreiben«, genauer betrachten. 
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Tür und Spieler auf dem Spielbrett 


Punkt-Objekte erscheinen auf den ersten Blick als mathematische Konstrukte, doch sie sind 
allgemein nutzbar. Alles, was eine Position im zweidimensionalen Raum hat, lässt sich gut 
durch ein Punkt-Objekt repräsentieren. Der Punkt speichert für uns ja x und y, und hätten wir 
keine Punkt-Objekte, so müssten wir x und y immer extra speichern. 


Nehmen wir an, wir wollen einen Spieler und eine Tür auf ein Spielbrett setzen. Natürlich 
haben die beiden Objekte Positionen. Ohne Objekte würde eine Speicherung der Koordina- 
ten vielleicht so aussehen: 

int playerX; 

int playerY; 

int doorX; 

int doorY; 


Die Modellierung ist nicht optimal, da wir mit der Klasse Point eine viel bessere Abstraktion 
haben, die zudem hübsche Methoden anbietet. 


ohne Abstraktion, nur die nackten Daten Kapselung der Zustände in ein Objekt 
int playerX; java.awt.Point player; 
int playerY; 


int doorX; java.awt.Point door; 
int doorY; 


Tabelle 3.2 Objekte kapseln Zustände. 


Das folgende Beispiel erzeugt zwei Punkte, die die x/y-Koordinate eines Spielers und einer 
Tür auf einem Spielbrett repräsentieren. Nachdem die Punkte erzeugt wurden, werden die 
Koordinaten gesetzt, und es wird außerdem getestet, wie weit der Spieler und die Tür vonei- 
nander entfernt sind: 


Listing 3.1 PlayerAndDoorAsPoints.java 
class PlayerAndDoorAsPoints { 


public static void main( String[] args ) { 
java.awt.Point player = new java.awt.Point(); 
player.x = player.y = 10; 


java.awt.Point door = new java.awt.Point(); 
door.setLocation( 10, 100 ); 


3.4 Neue Objekte erzeugen 


System.out.printlin( player.distance( door ) ); // 90.0 
} 
} 


Im ersten Fall belegen wir die Variablen x, y des Spiels explizit. Im zweiten Fall setzen wir 
nicht direkt die Objektzustände über die Variablen, sondern verändern die Zustände über die 
Methode setLocation(..). Die beiden Objekte besitzen eigene Koordinaten undkommen sich 
nicht in die Quere. 


PlayerAndDoorAsPoints 


> java: :awt::Point 


+ _main(String[ ]) 


Abbildung 3.4 Die Abhängigkeit zwischen einer Klasse und dem »java.awt.Point« zeigt das UML- 
Diagramm mit einer gestrichelten Linie an. Attribute und Operationen von »Point« sind nicht dar- 
gestellt. 


toString() 

Die Methode toString() liefert als Ergebnis ein String-Objekt, das den Zustand des Punktes 
preisgibt. Sie ist insofern besonders, als es immer aufjedem Objekt eine toString()-Methode 
gibt - nicht in jedem Fall ist die Ausgabe allerdings sinnvoll. 


Listing 3.2 PointToStringDemo.java 


class PointToStringDemo { 


public static void main( String[] args ) { 
java.awt.Point player = new java.awt.Point(); 
java.awt.Point door = new java.awt.Point(); 
door.setLocation( 10, 100 ); 


System.out.println( player.toString() ); // java.awt.Point[x=0,y=0] 
System.out.println( door ); // java.awt.Point[x=10,y=100] 


Tipp 

Anstatt für die Ausgabe explizit println(obj.toString()) aufzurufen, funktioniert auch ein 
printin(obj). Das liegt daran, dass die Signatur println(Object) jedes beliebige Objekt als 
Argument akzeptiert und auf diesem Objekt automatisch die toString()-Methode aufruft. 
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Nach dem Punkt geht’s weiter 
Die Methode toString() liefert, wie wir gesehen haben, als Ergebnis ein String-Objekt: 


java.awt.Point p = new java.awt.Point(); 
String s = p.toString(); 
System.out.println( s ); // java.awt.Point[x=0, y=O] 


Das String-Objekt besitzt selbst wieder Methoden. Eine davon ist length(), die die Länge der 
Zeichenkette liefert: 

System.out.printlin( s.length() ); // 23 

Das Erfragen des String-Objekts und seiner Länge können wir zu einer Anweisung verbin- 
den; wir sprechen von kaskadierten Aufrufen. 


java.awt.Point p = new java.awt.Point(); 
System.out.printlin( p.toString().length() ); // 23 


Objekterzeugung ohne Variablenzuweisung 


Bei der Nutzung von Objekteigenschaften muss der Typ links vom Punkt immer eine Refe- 
renz sein. Ob die Referenz nun aus einer Variablen kommt oder on-the-fly erzeugt wird, ist 
egal. Damit folgt, dass 


java.awt.Point p = new java.awt.Point(); 
System.out.printlin( p.toString().length() ); // 23 


genau das Gleiche bewirkt wie: 


System.out.println( new java.awt.Point().toString().length() ); // 23 


newPoint()|.toString().length() 


Typ: Point 


Typ: String 


Typ: int 


Abbildung 3.5 Jede Schachtelung ergibt einen neuen Typ. 


Im Prinzip funktioniert auch Folgendes: 
new java.awt.Point().x = 1; 
Dies ist hier allerdings unsinnig, da zwar das Objekt erzeugt und eine Objektvariable gesetzt 


wird, anschließend das Objekt aber für die automatische Speicherbereinigung wieder Frei- 
wild ist. 


3.4 Neue Objekte erzeugen 


Beispiel 

Finde über ein File-Objekt heraus, wie groß eine Datei ist: 

long size = new java.io.File( "file.txt" ).length(); 

Die Rückgabe der File-Methode length() ist die Länge der Datei in Bytes. 


3.4.4 Der Zusammenhang von new, Heap und Garbage-Collector 


Bekommt das Laufzeitsystem die Anfrage, ein Objekt mit new zu erzeugen, so reserviert es so 
viel Speicher, dass alle Objekteigenschaften und Verwaltungsinformationen dort Platz fin- 
den. Ein Point-Objekt speichert die Koordinaten in zwei int-Werten, also sind mindestens 2 
mal 4 Byte nötig. Den Speicherplatz nimmt die Laufzeitumgebung vom Heap. Der Heap 
wächst von einer Startgröße bis hin zu einer erlaubten Maximalgröße, damit ein Java-Pro- 
gramm nicht beliebig viel Speicher vom Betriebssystem abgreifen kann, was die Maschine 
möglicherweise in den Ruin treibt. In der HotSpot JVM ist der Heap zum Start !/,, des Haupt- 
speichers groß und wächst dann bis zur maximalen Größe von 14 des Hautspeichers.® 


Hinweis 

Es gibt in Java nur wenige Sonderfälle, in denen neue Objekte nicht über new angelegt werden. 
So erzeugt die auf nativem Code basierende Methode newInstance() vom Constructor- 
Objekt ein neues Objekt. Auch clone() kann ein neues Objekt als Kopie eines anderen Objekts 
erzeugen. Bei der String-Konkatenation mit + ist für uns zwar kein new zu sehen, doch der 
Compiler wird Anweisungen bauen, um das neue String-Objekt anzulegen. 


Ist das System nicht in der Lage, genügend Speicher für ein neues Objekt bereitzustellen, ver- 
sucht die automatische Speicherbereinigung in einer letzten Rettungsaktion, alles Unge- 
brauchte wegzuräumen. Ist dann immer noch nicht ausreichend Speicher frei, generiert die 
Laufzeitumgebung einen OutOfMemoryError und beendet das gesamte Programm.” 


Heap und Stack 

Die JVM-Spezifikation sieht für Daten fünf verschiedene Speicherbereiche (engl. runtime 
data areas) vor.® Neben dem Heap-Speicher wollen wir uns den Stack-Speicher (Stapelspei- 
cher) kurz anschauen. Den nutzt die Java-Laufzeitumgebung zum Beispiel für lokale Varia- 
blen. Auch verwendet Java den Stack beim Methodenaufruf mit Parametern. Die Argumente 


6 https://docs.oracle.com/en/java/javase/17/gctuning/ergonomics.html 

7 Diese besondere Ausnahme kann aber auch abgefangen werden. Das ist für den Serverbetrieb wichtig, 
denn wenn ein Puffer zum Beispiel nicht erzeugt werden kann, soll nicht gleich die ganze JVM stoppen. 

8 $2.5 der JVM-Spezifikation, https://docs.oracle.com/javase/specs/jvms/se17/htmi/jvms-2.html#jvms-2.5 
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kommen vor dem Methodenaufruf auf den Stapel, und die aufgerufene Methode kann über 
den Stack auf die Werte lesend oder schreibend zugreifen. Bei endlosen rekursiven Metho- 
denaufrufen ist irgendwann die maximale Stack-Größe erreicht, und es kommt zu einer 
Exception vom Typ java.lang.StackOverflowError. Da mit jedem Thread ein JVM-Stack asso- 
ziiert ist, bedeutet das das Ende des Threads, wobei andere Threads unbeeindruckt weiter- 
laufen. 


Automatische Speicherbereinigung/Garbage-Collector (GC) - es ist dann mal weg 


Nehmen wir folgendes Szenario an: 


java.awt.Point binariumlLocation; 
binariumLocation = new java.awt.Point( 50, 9 ); 
binariumLocation = new java.awt.Point( 51, 7 ); 


Wir deklarieren eine Point-Variable, bauen ein Exemplar auf und belegten die Variable. Dann 
bauen wir ein neues Point-Objekt auf und überschreiben die Variable. Doch was ist mit dem 
ersten Punkt? 


Wird das Objekt nicht mehr vom Programm referenziert, so bemerkt dies die automatische 
Speicherbereinigung alias der Garbage-Collector (GC) und gibt den reservierten Speicher wie- 
der frei.? Die automatische Speicherbereinigung testet dazu regelmäßig, ob die Objekte auf 
dem Heap noch benötigt werden. Werden sie nicht benötigt, löscht der Objektjäger sie. Es 
weht also immer ein Hauch von Friedhof über dem Heap, und nachdem die letzte Referenz 
vom Objekt genommen wird, ist es auch schon tot. Es gibt verschiedene GC-Algorithmen, 
und jeder Hersteller einer JVM hat eigene Verfahren. 


3.4.5 Überblick über Point-Methoden 


Ein paar Methoden der Klasse Point kamen schon vor, und die API-Dokumentation zählt 
selbstverständlich alle Methoden auf. Die interessanteren sind: 


class java.awt.Point 


= double getX() 
= double getY() 
Liefert die x- bzw. y-Koordinate. 


m voidsetlocation(double x, double y) 
Setzt gleichzeitig die x- und die y-Koordinate. Die Koordinaten werden gerundet und in 
Ganzzahlen gespeichert. 


9 Mit dem gesetzten java-Schalter -verbose:gc gibt es immer Konsolenausgaben, wenn der GC nicht mehr 
referenzierte Objekte erkennt und wegräumt. 
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m boolean equals(Object obj) 


3.4 Neue Objekte erzeugen 


Prüft, ob ein anderer Punkt die gleichen Koordinaten besitzt. Dann ist die Rückgabe true, 


sonst false. Wird etwas anderes als ein Point übergeben, so wird der Compiler das nicht 


bemäkeln, nur wird das Ergebnis dann immer false sein. 


java: :lang: :Object 


Object() 

getClass() : Class<?> 

hashCode() : int 

equals(obj : Object) : boolean 
toString() : String 

notify() 

notifyAll() 

wait(timeout : long) 

wait(timeout : long, nanos : int) 
wait() 


java: :awt::geom: :Point2D 


getX() : double 

getY() : double 

setLocation(x : double, y : double) 
setLocation(p : Point2D) 


distanceSq(x1 : double, y1 : double, x2 : double, y2 


: double) : double 


distance(x1 : double, y1 : double, x2 : double, y2 : 


double) : double 


distanceSq(px : double, py : double) : double 
distanceSq(pt : Point2D) : double 

distance(px : double, py : double) : double 
distance(pt : Point2D): double 

clone() : Object 

hashCode() : int 

equals(obj : Object) : boolean 


+4 H+ +++ HH ttt 


Float 


Double 


java: :awt 


Xix 
yEy 


Point() 

Point(p : Point) 

Point(x : int, y : int) 

getX() : double 

getY() : double 

getLocation() : Point 
setLocation(p : Point) 
setLocation(x : int, y : int) 
setLocation(x : double, y : double) 
move(x : int, y : int) 
translate(dx : int, dy : int) 
equals(obj : Object) : boolean 
toString() : String 


Abbildung 3.6 Vererbungshierarchie bei Point2D 
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Hinweis 

Es ist überraschend, dass ein Point die Koordinaten als int speichert, aber die Methoden 
getX() und getY() ein double liefern und setLocation(double, double)die Koordinaten als 
double annimmt, rundet und als int ablegt, also Genauigkeit verliert. Der Grund hat etwas 
mit Vererbung zu tun, was in Kapitel 7 ausführlicher beleuchtet wird. Point erbt von Point2D, 
und dort gibt es schon double getX(), double getY() und setLocation(double, double); die 
Unterklasse Point kann nicht einfach aus double ein int machen. 


Ein paar Worte über Vererbung und die API-Dokumentation * 


Eine Klasse besitzt nicht nur eigene Eigenschaften, sondern erbt auch immer welche von 
ihren Eltern. Im Fall von Point ist die Oberklasse Point2D -so sagt es die API-Dokumentation. 
Selbst Point2D erbt von Object, einer magischen Klasse, die alle Java-Klassen als Oberklasse 
haben. Der Vererbung widmen wir später ein sehr ausführliches Kapitel 7, »Objektorientierte 
Beziehungsfragen«, aber es ist jetzt schon wichtig zu verstehen, dass die Oberklasse Objekt- 
variablen und Methoden an Unterklassen weitergibt. Sie sind in der API-Dokumentation 
einer Klasse nur kurz im Block »Methods inherited from ...« aufgeführt und gehen schnell 
unter. Für Entwickler ist es unabdingbar, nicht nur bei den Methoden der Klasse selbst zu 
schauen, sondern auch bei den geerbten Methoden. Bei Point sind es also nicht nur die 
Methoden dort selbst, sondern auch die Methoden aus Point2D und Object. 


Nehmen wir uns einige Methoden der Oberklasse vor. Die Klassendeklaration von Point ent- 
hält ein extends Point2D, was explizit klarmacht, dass es eine Oberklasse gibt:!0 


class java.awt.Point 
extends Point2D 


static double distance(double x1, double y1, double x2, double y2) 

Berechnet den Abstand zwischen den gegebenen Punkten nach der euklidischen Distanz. 
double distance(doublex, double y) 

Berechnet den Abstand des aktuellen Punktes zu angegebenen Koordinaten. 

double distance(Point2D pt) 

Berechnet den Abstand des aktuellen Punktes zu den Koordinaten des übergebenen 
Punktes. 


Sind zwei Punkte gleich? 


Ob zwei Punkte gleich sind, sagt uns die equals (..)-Methode. Die Anwendung ist einfach. Stel- 
len wir uns vor, wir wollen Koordinaten für einen Spieler, eine Tür und eine Schlange verwal- 


10 Damit ist die Klassendeklaration noch nicht vollständig, da ein implements Serializable fehlt, doch das 
soll uns jetzt erst einmal egal sein. 
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ten und dann testen, ob der Spieler »auf« der Tür steht und die Schlange auf der Position des 
Spielers: 


Listing 3.3 PointEqualsDemo.java 


class PointEqualsDemo { 


public static void main( String[] args ) { 
java.awt.Point player = new java.awt.Point(); 
player.x = player.y = 10; 


java.awt.Point door = new java.awt.Point(); 
door.setlocation( 10, 10 ); 


System.out.printlin( player.equals( door ) ); // true 
System.out.printlin( door.equals( player ) ); // true 


java.awt.Point snake = new java.awt.Point(); 
snake.setLocation( 20, 22 ); 


System.out.println( snake.equals( door ) ); // false 
} 
} 


Da Spieler und Tür die gleichen Koordinaten besitzen, liefert equals (..) die Rückgabe true. Ob 
wir den Abstand vom Spieler zur Tür berechnen lassen oder den Abstand von der Tür zum 
Spieler - das Ergebnis bei equals (..) sollte immer symmetrisch sein. 


Eine andere Testmöglichkeit ergibt sich durch distance(..), denn ist der Abstand der Punkte 
null, so liegen die Punkte natürlich aufeinander und haben keinen Abstand. 


Listing 3.4 Distances.java 


class Distances { 


public static void main( String[] args ) { 
java.awt.Point player = new java.awt.Point(); 
player.setLocation( 10, 10 ); 
java.awt.Point door = new java.awt.Point(); 
door.setLocation( 10, 10 ); 
java.awt.Point snake = new java.awt.Point(); 
snake.setLocation( 20, 10 ); 


System.out.println( player.distance( door ) ); 
System.out.printlin( player.distance( snake ) ); 
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System.out.println( player.distance( snake.x, snake.y ) ); // 10.0 
} 
} 


Spieler, Tür und Schlange sind wieder als Point-Objekte repräsentiert und mit Positionen 
vorbelegt. Beim player rufen wir die Methode distance(..) auf und übergeben den Verweis 
auf die Tür und die Schlange. 


3.4.6 Konstruktoren nutzen 


Werden Objekte mit new angelegt, so wird ein Konstruktor aufgerufen. Ein Konstruktor hat 
die Aufgabe, ein Objekt in einen Startzustand zu versetzen, zum Beispiel die Objektvariablen 
zu initialisieren. Ein Konstruktor ist dazu ein guter Weg, denn er wird immer als Erstes auf- 
gerufen, noch bevor eine andere Methode aufgerufen wird. Die Initialisierung im Konstruk- 
tor stellt sicher, dass das neue Objekt einen sinnvollen Anfangszustand aufweist. 


Aus der API-Dokumentation von Point sind drei Konstruktoren abzulesen: 


class java.awt.Point 
extends Point2D 


Point() 

Legt einen Punkt mit den Koordinaten (O, O) an. 

Point(intx, int y) 

Legt einen neuen Punkt an und initialisiert ihn mit den Werten aus x und y. 

Point(Point p) 

Legt einen neuen Punkt an und initialisiert ihn mit den gleichen Koordinaten, die der 
übergebene Punkt hat. Wir nennen so einen Konstruktor auch Copy-Konstruktor. 


Ein Konstruktor ohne Argumente ist der parameterlose Konstruktor, selten auch No-Arg- 
Konstruktor genannt. Jede Klasse kann höchstens einen parameterlosen Konstruktor besit- 
zen, es kann aber auch sein, dass eine Klasse keinen parameterlosen Konstruktor deklariert, 
sondern nur Konstruktoren mit Parametern, also parametrisierte Konstruktoren. 


Beispiel 

Die drei folgenden Varianten legen ein Point-Objekt mit denselben Koordinaten (1, 2) an; 
java.awt.Point ist mit Point abgekürzt: 

Point p = new Point(); p.setLocation( 1, 2 ); 

Point q = new Point( 1, 2 ); 

Point r = new Point( q ); 

Als Erstes steht der parameterlose Konstruktor, im zweiten und dritten Fall handelt es sich um 
parametrisierte Konstruktoren. 


3.5 ZZZZZnake 


3.5 ZZZZZnake 


Ein Klassiker aus dem Genre der Computerspiele ist Snake. Auf dem Bildschirm gibt es den 
Spieler, eine Schlange, Gold und eine Tür. Die Tür und das Gold sind fest, den Spieler können 
wir bewegen, und die Schlange bewegt sich selbstständig auf den Spieler zu. Wir müssen ver- 
suchen, die Spielfigur zum Gold zu bewegen und dann zur Tür. Wenn die Schlange uns vor- 
her erwischt, haben wir Pech gehabt, und das Spiel ist verloren. 


Vielleicht hört sich das auf den ersten Blick komplex an, aber wir haben alle Bausteine zusam- 
men, um dieses Spiel zu programmieren: 


> Spieler, Schlange, Gold und Tür sind Point-Objekte, die mit Koordinaten vorkonfiguriert 
sind. 


Eine Schleife läuft alle Koordinaten ab. Ist ein Spieler, die Tür, die Schlange oder Gold 
»getroffen«, gibt es eine symbolische Darstellung der Figuren. 


Wir testen drei Bedingungen für den Spielstatus: 1. Hat der Spieler das Gold eingesammelt 
und steht auf der Tür? (Das Spiel ist zu Ende.) 2. Beißt die Schlange den Spieler? (Das Spiel 
ist verloren.) 3. Sammelt der Spieler Gold ein? 


Mit dem Scanner können wir auf Tastendrücke reagieren und den Spieler auf dem Spiel- 
brett bewegen. 


Die Schlange muss sich in Richtung des Spielers bewegen. Während der Spieler sich nur 
entweder horizontal oder vertikal bewegen kann, erlauben wir der Schlange, sich diagonal 
zu bewegen. 


Im Quellcode sieht das so aus: 


Listing 3.5 ZZZZZnake.java 
public class ZZZZZnake { 


public static void main( String[] args ) { 
java.awt.Point playerPosition = new java.awt.Point( 10, 9 ); 
java.awt.Point snakePosition new java.awt.Point( 30, 2 ); 
java.awt.Point goldPosition new java.awt.Point( 6, 6 ); 
java.awt.Point doorPosition new java.awt.Point( 0, 5 ); 
boolean rich = false; 


while ( true ) { 
// Raster mit Figuren zeichnen 


for ( int y = 0; y < 10; y++ ) { 
for ( int x = 0; x < 40; x+ ) { 
java.awt.Point p = new java.awt.Point( x, y ); 
if ( playerPosition.equals( p ) ) 
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.out.print( '&' ); if ( playerPosition.y < snakePosition.y ) 

( snakePosition.equals( p ) ) snakePosition.y--; 

.out.print( 'S' ); else if ( playerPosition.y > snakePosition.y ) 
( goldPosition.equals( p ) ) snakePosition.y++; 

.out.print( '$' ); } // end while 

( doorPosition.equals( p ) ) } 

System.out.print( '#' ); } 


lse System.out.print( '.' ); 
} 4 Die Point-Eigenschaften, die wir nutzen, sind: 


System.out.printlin(); > Die Objektzustände x, y: Der Spieler und die Schlange werden bewegt, und die Koordinaten 
} müssen neu gesetzt werden. 
Die Methode setlocation(..): Ist das Gold aufgesammelt, setzen wir die Koordinaten so, 
dass die Koordinate vom Gold nicht mehr auf unserem Raster liegt. 


// Status feststell 
if ( rich 88 playerPosition.equals( doorPosition ) ) { Die Methode equals (..): Testet, ob ein Punkt auf einem anderen Punkt steht. 


System.out.println( "Gewonnen!" ); 
return; Erweiterung 


} Wer Lust hat, an der Aufgabe noch ein wenig weiterzuprogrammieren, der kann Folgendes 
if ( playerPosition.equals( snakePosition ) ) { tun: 
System.out.printlin( "ZZZZZZZ. Die Schlange hat dich!" ); 


return; 
} Statt nur eines Stücks Gold soll es zwei Stücke geben. 


Spieler, Schlange, Gold und Tür sollen auf Zufallskoordinaten gesetzt werden. 


if ( playerPosition.equals( goldPosition ) ) { Statt einer Schlange soll es zwei Schlangen geben. 
rich = true; 


Mit zwei Schlangen und zwei Stücken Gold kann es etwas eng für den Spieler werden. Er 
goldPosition.setLocation( -1, -1 ); 


soll daher am Anfang 5 Züge machen können, ohne dass die Schlangen sich bewegen. 


} 


Für Vorarbeiter: Das Programm, das sich bisher nur in der main-Methode befindet, soll in 


// Konsoleneingabe und Spielerposition verändern verschiedene Methoden aufgespalten werden. 


switch ( new java.util.Scanner( System.in ).next() ) { 
// Spielfeld ist im Bereich 0/0 .. 39/9 3.6 Pakete schnüren, Importe und Compilationseinheiten 
case "h" : playerPosition.y = Math.max( 0, playerPosition.y - 1 ); break; 
case "t" : playerPosition.y = Math.min( 9, playerPosition.y + 1 ); break; 
case "1" : playerPosition.x = Math.max( 0, playerPosition.x - 1 ); break; 


case "r" : playerPosition.x = Math.min( 39, playerPosition.x + 1 ); break; 


Die Klassenbibliothek von Java ist mit Tausenden Typen sehr umfangreich und deckt alles 
ab, was Entwickler von plattformunabhängigen Programmen als Basis benötigen. Dazu 
gehören Datenstrukturen, Klassen zur Datums-/Zeitberechnung, Dateiverarbeitung usw. 
Die meisten Typen sind in Java selbst implementiert (und der Quellcode ist in der Regel aus 


der Entwicklungsumgebung direkt verfügbar), aber einige Teile sind nativ implementiert, 
// Schlange bewegt sich in Richtung Spieler etwa wenn es darum geht, aus einer Datei zu lesen. 


Wenn wir eigene Klassen programmieren, ergänzen sie sozusagen die Standardbibliothek; 


if ( playerPosition.x < snakePosition.x ) im Endeffekt wächst damit die Anzahl der möglichen Typen, die ein Programm nutzen kann. 
snakePosition.x--; 


else if ( playerPosition.x > snakePosition.x ) 
snakePosition.x++; 
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3.6.1 Java-Pakete 


Ein Paket ist eine Gruppe thematisch zusammengehöriger Typen. Pakete lassen sich in Hie- 
rarchien ordnen, sodass ein Paket wieder ein anderes Paket enthalten kann; das ist genauso 
wie bei der Verzeichnisstruktur des Dateisystems. Beispiele für Pakete sind: 


java.awt 


java.util 


org.apache.commons.math3.fraction 


> 
> 
>» com.google 
> 
> 


com.tutego.insel 


Die Klassen der Java-Standardbibliothek befinden sich in Paketen, die mit java und javax 
beginnen. Google nutzt die Wurzel com.google; die Apache Foundation veröffentlicht Java- 
Code unter org.apache. So können wir von außen ablesen, von welchen Typen die eigene 
Klasse abhängig ist. 


3.6.2 Pakete der Standardbibliothek 


Die logische Gruppierung und Hierarchie lässt sich sehr gut an der Java-Bibliothek beobach- 
ten. Die Java-Standardbibliothek beginnt mit der Wurzel java, einige Typen liegen in javax. 
Unter diesem Paket liegen weitere Pakete, etwa awt, math und util. In java.math liegen zum 
Beispiel die Klassen BigInteger und BigDecimal, denn die Arbeit mit beliebig großen Ganz- 
und Fließkommazahlen gehört eben zum Mathematischen. Ein Punkt und ein Polygon, 
repräsentiert durch die Klassen Point und Polygon, gehören in das Paket für grafische Ober- 
flächen, und das ist das Paket java . awt. 


Wenn jemand eigene Klassen in Pakete mit dem Präfix java setzen würde, etwa java.tutego, 
würde ein Programmautor damit Verwirrung stiften, da nicht mehr nachvollziehbar ist, ob 
das Paket Bestandteil jeder Distribution ist. Daher ist dieses Präfix für eigene Pakete ver- 
boten. 


Klassen, die in einem Paket liegen, das mit javax beginnt, können Teil der Java SE sein wie 
javax.swing, müssen aber nicht zwingend zur Java SE gehören; dazu folgt mehr in Abschnitt 
16.1.2, »Übersicht über die Pakete der Standardbibliothek«. 


3.6.3 Volle Qualifizierung und import-Deklaration 


Um die Klasse Point, die im Paket java .awt liegt, außerhalb des Pakets java.awt zu nutzen - 
und das ist für uns Nutzer immer der Fall-, muss sie dem Compiler mit der gesamten Paket- 
angabe bekannt gemacht werden. Hierzu reicht der Klassenname allein nicht aus, denn es 
kann ja sein, dass der Klassenname mehrdeutig ist und eine Klassendeklaration in unter- 
schiedlichen Paketen existiert. 


3.6 Pakete schnüren, Importe und Compilationseinheiten 


Typen sind erst durch die Angabe ihres Pakets eindeutig identifiziert. Ein Punkt trennt 
Pakete, also schreiben wir java.awt und java.util- nicht einfach nur awt oder util. Mit einer 
weltweit unzähligen Anzahl von Paketen und Klassen wäre sonst eine Eindeutigkeit gar nicht 
machbar. Es kann in verschiedenen Paketen durchaus ein Typ mit gleichem Namen vorkom- 
men, etwa java.util.List und java.awt.List oder java.util.Date und java.sql.Date. Daher 
bilden nur Paket und Typ zusammen eine eindeutige Kennung. 


Um dem Compiler die präzise Zuordnung einer Klasse zu einem Paket zu ermöglichen, gibt 
es zwei Möglichkeiten: Zum einen lassen sich die Typen voll qualifizieren, wie wir das bisher 
getan haben. Eine alternative und praktischere Möglichkeit besteht darin, den Compiler mit 
einer import-Deklaration auf die Typen im Paket aufmerksam zu machen: 


Listing 3.6 AwtWithoutlmport.java Listing 3.7 AwtWithlmport.java 


import java.awt.Point; 
import java.awt.Polygon; 


class AwtWithoutImport { class AwtWithImport { 
public static void main(String[] args){ public static void main(String|[] args){ 
java.awt.Point p = Point p = new Point(); 
new java.awt.Point(); 


java.awt.Polygon t = Polygon t = new Polygon(); 
new java.awt.Polygon(); 

t.addPoint( 10, 10 ); t.addPoint( 10, 10 ); 

t.addPoint( 10, 20 ); t.addPoint( 10, 20 ); 

t.addPoint( 20, 10 ); t.addPoint( 20, 10 ); 


System.out.println( p ); System.out.println( p ); 
System.out.println( t.contains(15, > System.out.println( t.contains(15, 


15) ); 15) ); 


Tabelle 3.3 Typzugriff über volle Qualifikation und mit »import«-Deklaration 


Während der Quellcode auf der linken Seite die volle Qualifizierung verwendet und jeder 
Verweis auf einen Typ mehr Schreibarbeit kostet, ist im rechten Fall beim import nur der Klas- 
senname genannt und die Paketangabe in ein import »ausgelagert«. Alle Typen, die bei import 
genannt werden, merkt sich der Compiler für diese Datei in einer Datenstruktur. Kommt der 
Compiler zur Zeile mit Point p = new Point ();, findet er den Typ Point in seiner Datenstruktur 
und kann den Typ dem Paket java. awt zuordnen. Damit ist wieder die unabkömmliche Qua- 
lifizierung gegeben. 


D] 
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Hinweis 
Die Typen aus java. lang sind automatisch importiert, sodass z. B. ein import java. lang. 
String; nicht nötig ist. 


3.6.4 Mit import p1.p2.* alle Typen eines Pakets erreichen 


Greift eine Java-Klasse auf mehrere andere Typen des gleichen Pakets zurück, kann die 
Anzahl der import-Deklarationen groß werden. In unserem Beispiel nutzen wir mit Point und 
Polygon nur zwei Klassen aus java.awt, aber es lässt sich schnell ausmalen, was passiert, wenn 
aus dem Paket für grafische Oberflächen zusätzlich Fenster, Beschriftungen, Schaltflächen, 
Schieberegler usw. eingebunden werden. In diesem Fall darf ein * als letztes Glied in einer 
import-Deklaration stehen: 

import java.ant.*; 

import java.math.*; 


Mit dieser Syntax kennt der Compiler alle Typen im Paket java.awt und java.math, sodass der 
Compiler das Paket für die Klassen Point und Polygon zuordnen kann, wie auch das Paket für 
die Klasse BigInteger. 


Hinweis 

Das * ist nur auf der letzten Hierarchieebene erlaubt und gilt immer für alle Typen in diesem 
Paket. Syntaktisch falsch sind: 

import *; // ® Syntax error on token "*", Identifier expected 

import java.awt.Po*; // 2 Syntax error on token "*", delete this token 

Eine Anweisung wie import java.*; ist zwar syntaktisch korrekt, aber dennoch ohne Wir- 
kung, denn direkt im Paket java gibt es keine Typdeklarationen, sondern nur Unterpakete. 
Die import-Deklaration bezieht sich nur auf ein Verzeichnis (in der Annahme, dass die Pakete 
auf das Dateisystem abgebildet werden) und schließt die Unterverzeichnisse nicht ein. 


Das * verkürzt zwar die Anzahl der individuellen import-Deklarationen, es ist aber gut, zwei 
Dinge im Kopf zu behalten: 


» Falls zwei unterschiedliche Pakete einen gleichlautenden Typ beherbergen, etwa Date in 
java.util und java.sql oder Listin java.awt und java.util, so kommt es bei der Verwen- 
dung des Typs zu einem Übersetzungsfehler, weil der Compiler nicht weiß, was gemeint 
ist. Eine volle Qualifizierung löst das Problem. 


3.6 Pakete schnüren, Importe und Compilationseinheiten 


> Die Anzahl der import-Deklarationen sagt etwas über den Grad der Komplexität aus. Je 
mehr import-Deklarationen es gibt, desto größer werden die Abhängigkeiten zu anderen 
Klassen, was im Allgemeinen ein Alarmzeichen ist. Zwar zeigen grafische Tools die Abhän- 
gigkeiten genau an, doch ein import * kann diese erst einmal verstecken. 


Best Practice 


Entwicklungsumgebungen setzen die import-Deklarationen in der Regel automatisch und 
falten die Blöcke üblicherweise ein. Daher sollte der * nur sparsam eingesetzt werden, denn 
er »verschmutzt« den Namensraum durch viele Typen und erhöht die Gefahr von Kollisionen. 


3.6.5 Hierarchische Strukturen über Pakete und die Spiegelung im Dateisystem 


Die zu einem Paket gehörenden Klassen befinden sich normalerweise” im gleichen Verzeich- 
nis. Der Name des Pakets ist gleich dem Namen des Verzeichnisses (und natürlich umge- 
kehrt). Statt des Verzeichnistrenners (etwa »/« oder »\«) steht ein Punkt. 


Nehmen wir folgende Verzeichnisstruktur mit einer Hilfsklasse an: 
com/tutego/insel/printer/DatePrinter.class 


Hier ist der Paketname com.tutego.insel.printer und somit der Verzeichnisname com/ 
tutego/insel/printer. Umlaute und Sonderzeichen sollten vermieden werden, da sie auf dem 
Dateisystem immer wieder für Ärger sorgen. Aber Bezeichner sollten ja sowieso immer auf 
Englisch sein. 


Der Aufbau von Paketnamen 


Prinzipiell kann ein Paketname beliebig sein, doch Hierarchien bestehen in der Regel aus 
umgedrehten Domänennamen. Aus der Domäne zur Webseite http://tutego.com wird also 
com.tutego. Diese Namensgebung gewährleistet, dass Klassen auch weltweit eindeutig blei- 
ben. Ein Paketname wird in aller Regel komplett kleingeschrieben. 


3.6.6 Die package-Deklaration 

Um die Klasse DatePrinter in ein Paket com.tutego.insel.printer zu setzen, müssen zwei 
Dinge gelten: 

> Sie muss sich physisch in einem Verzeichnis befinden, also in com/tutego/insel/printer. 


> Der Quellcode enthält zuoberst eine package-Deklaration. 


11 Ich schreibe »normalerweise«, da die Paketstruktur nicht zwingend auf Verzeichnisse abgebildet werden 
muss. Pakete könnten beispielsweise vom Klassenlader aus einer Datenbank gelesen werden. Im Folgen- 
den wollen wir aber immer von Verzeichnissen ausgehen. 
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Die package-Deklaration muss ganz am Anfang stehen, sonst gibt es einen Übersetzungsfeh- 
ler (selbstverständlich lassen sich Kommentare vor die package-Deklaration setzen): 


Listing 3.8 src/main/java/com/tutego/insel/printer/DatePrinter.java 


package com.tutego.insel.printer; 


import java.time.LocalDate; 
import java.time.format.*; 


public class DatePrinter { 
public static void printCurrentDate() { 
DateTimeFormatter fmt = DateTimeFormatter.ofLocalizedDate( FormatStyle.MEDIUM ); 
System.out.printin( LocalDate.now().format( fmt ) ); 
} 
} 


Hinter die package-Deklaration kommen wie gewohnt import-Deklaration(en) und die Typ- 
deklaration(en). 


Um die Klasse zu nutzen, bieten sich wie bekannt zwei Möglichkeiten: einmal über die volle 
Qualifizierung und einmal über die import-Deklaration. Die erste Variante sieht so aus: 


Listing 3.9 src/main/java/DatePrinterUserl.java 
public class DatePrinterUserl { 
public static void main( String[] args ) { 
com.tutego.insel.printer.DatePrinter.printCurrentDate(); 
} 
} 


Und hier ist die Variante mit der import-Deklaration: 


Listing 3.10 src/main/java/DatePrinterUser2.java 


import com.tutego.insel.printer.DatePrinter; 


public class DatePrinterUser2 { 
public static void main( String[] args ) { 
DatePrinter.printCurrentDate(); 
} 
} 


3.6 Pakete schnüren, Importe und Compilationseinheiten 


Tipp 
Eine Entwicklungsumgebung nimmt uns viel Arbeit ab, daher bemerken wir die Dateiopera- 
tionen — wie das Anlegen von Verzeichnissen — in der Regel nicht. Auch das Verschieben von 
Typen in andere Pakete und die damit verbundenen Änderungen im Dateisystem und die 
Anpassungen an den import- und package-Deklarationen übernimmt eine moderne IDE für 
uns. 


3.6.7 Unbenanntes Paket (default package) 


Eine Klasse ohne Paketangabe befindet sich im unbenannten Paket (engl. unnamed package) 
bzw. Default-Paket. Es ist eine gute Idee, eigene Klassen immer in Paketen zu organisieren. 
Das erlaubt auch feinere Sichtbarkeiten, und Konflikte mit anderen Unternehmen und Auto- 
ren werden vermieden. Es wäre ein großes Problem, wenn a) jedes Unternehmen unüber- 
sichtlich alle Klassen in das unbenannte Paket setzen und dann b) versuchen würde, die 
Bibliotheken auszutauschen: Konflikte wären vorprogrammiert. 


Eine im Paket befindliche Klasse kann jede andere sichtbare Klasse aus anderen Paketen 
importieren, aber keine Klassen aus dem unbenannten Paket. Nehmen wir Sugar im unbe- 
nannten Paket und Chocolate im Paket com.tutego an: 


Sugar.class 
com/tutego/insel/Chocolate.class 


[È Package Explorer 32 E8|% 
= com,.tutego.greeter 
E com.tutego.main 
vi Inselprogramme 
v Æ src/main/java 
# (default package) 
# com.tutego.insel.annotation 
## com.tutego.insel.ant 
## com.tutego.insel.array 
# com.tutego.insel.assertion 
# com.tutego.insel.awt 
# com.tutego.insel.bean.bound 
# com.tutego.insel.bean.validation 
# com.tutego.insel.bean.veto 
## com.tutego.insel.bundle 


Abbildung 3.7 Das Verzeichnis »default package« steht in Eclipse 
für das unbenannte Paket. IntelliJ zeigt es nicht besonders an. 


Die Klasse Chocolate kann Sugar nicht nutzen, da Klassen aus dem unbenannten Paket nicht 
für Unterpakete sichtbar sind. Nur andere Klassen im unbenannten Paket können Klassen 
im unbenannten Paket nutzen. 
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Stände nun Sugar in einem Paket - das auch ein Oberpaket sein kann! -, so wäre das wiede- 
rum möglich, und Chocolate könnte Sugar importieren: 


com/Sugar.class 
com/tutego/insel/Chocolate.class 


3.6.8 Compilationseinheit (Compilation Unit) 


Eine.java-Datei ist eine Compilationseinheit (Compilation Unit), die aus drei (optionalen) Seg- 
menten besteht - in dieser Reihenfolge: 


1. package-Deklaration 
2. import-Deklaration(en) 


3. Typdeklaration(en) 


So besteht eine Compilationseinheit aus höchstens einer Paketdeklaration (nicht nötig, 
wenn der Typ im Default-Paket stehen soll), beliebig vielen import-Deklarationen und belie- 
big vielen Typdeklarationen. Der Compiler übersetzt jeden Typ einer Compilationseinheit in 
eine eigene .class-Datei. Ein Paket ist letztendlich eine Sammlung aus Compilationseinhei- 
ten. In der Regel ist die Compilationseinheit eine Quellcodedatei; die Codezeilen könnten 
grundsätzlich auch aus einer Datenbank kommen oder zur Laufzeit generiert werden. 


3.6.9 Statischer Import * 


Die import-Deklaration informiert den Compiler über die Pakete, sodass ein Typ nicht mehr 
voll qualifiziert werden muss, wenn er im import-Teil explizit aufgeführt wird oder wenn das 
Paket des Typs über * genannt ist. 


Falls eine Klasse statische Methoden oder Konstanten vorschreibt, werden ihre Eigenschaf- 
ten immer über den Typnamen angesprochen. Java bietet mit dem statischen Import die 
Möglichkeit, die statischen Methoden oder Variablen ohne vorangestellten Typnamen 
sofort zu nutzen. Während also das normale import dem Compiler Typen benennt, macht ein 
statisches import dem Compiler Klasseneigenschaften bekannt, geht also eine Ebene tiefer. 


Beispiel 
Binde für die Bildschirmausgabe die statische Variable out aus Systen statisch ein: 
import static java.lang.System.out; 


Bei der sonst üblichen Ausgabe über System.out.print*(..) kann nach dem statischen Import 
der Klassenname entfallen, und es bleibt beim out. print*(...). 


Binden wir in einem Beispiel mehrere statische Eigenschaften mit einem statischen import 
ein: 
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Listing 3.11 src/main/java/com/tutego/insel/oop/Staticlmport.java 


package com.tutego.insel.oop; 


import static java.lang.System.out; 

import static javax.swing.JOptionPane.showInputDialog; 
import static java.lang.Integer.parselnt; 

import static java.lang.Math.max; 

import static java.lang.Math.min; 


class StaticImport { 


public static void main( String[] args ) { 
int i = parseInt( showInputDialog( "Erste Zahl" ) ); 
int j = parseInt( showInputDialog( "Zweite Zahl" ) ); 
out.printf( "%d ist größer oder gleich %d.%n", 


max(i, j), min(i, j) ); 


Mehrere Typen statisch importieren 
Der statische Import 


import static java.lang.Math.max; 
import static java.lang.Math.min; 


bindet die statische max(..)/min(..)-Methode ein. Besteht Bedarf an weiteren statischen 
Methoden, gibt es neben der individuellen Aufzählung eine Wildcard-Variante: 


import static java.lang.Math.*; 


Best Practice 


Auch wenn Java diese Möglichkeit bietet, sollte der Einsatz maßvoll erfolgen. Die Möglichkeit 
der statischen Importe ist nützlich, wenn Klassen Konstanten nutzen wollen, allerdings 
besteht auch die Gefahr, dass durch den fehlenden Typnamen nicht mehr sichtbar ist, woher 
die Eigenschaft eigentlich kommt und welche Abhängigkeit sich damit aufbaut. Auch gibt es 
Probleme mit gleichlautenden Methoden: Eine Methode aus der eigenen Klasse überdeckt 
statisch importierte Methoden. Wenn also später in der eigenen Klasse — oder Oberklasse — 
eine Methode aufgenommen wird, die die gleiche Signatur hat wie eine statisch importierte 
Methode, wird das zu keinem Compilerfehler führen, sondern die Semantik wird sich ändern, 
weil jetzt die neue eigene Methode verwendet wird und nicht mehr die statisch importierte. 
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3.7 Mit Referenzen arbeiten, Vielfalt, Identität, Gleichwertigkeit 


In Java gibt es mit null eine sehr spezielle Referenz, die Auslöser vieler Probleme ist. Doch 
ohne sie geht es nicht, und warum das so ist, wird der folgende Abschnitt zeigen. Anschlie- 
ßend wollen wir sehen, wie Objektvergleiche funktionieren und was der Unterschied zwi- 
schen Identität und Gleichwertigkeit ist. 


3.7.1 null-Referenz und die Frage der Philosophie 


In Java gibt es drei spezielle Referenzen: null, this und super. (Wir verschieben die Beschrei- 
bung von this und super auf Kapitel 6, »Eigene Klassen schreiben«.) Das spezielle Literal null 
lässt sich zur Initialisierung von Referenzvariablen verwenden. Die null-Referenz ist typen- 
los, kann also jeder Referenzvariablen zugewiesen und jeder Methode übergeben werden, die 
ein Objekt erwartet.!? 


Beispiel 

Deklaration und Initialisierung zweier Objektvariablen mit null: 
Point p = null; 

String s = null; 

System.out.printIn( p ); // null 


Die Konsolenausgabe über die letzte Zeile liefert kurz »null«. Wir haben hier die String-Reprä- 
sentation vom null-Typ vor uns. 


Da null typenlos ist und es nur ein null gibt, kann null zu jedem Typ typangepasst werden, 
und so ergibt zum Beispiel ( (String) null == null && (Point) null == null das Ergebnis true. 
Das Literal null ist ausschließlich für Referenzen vorgesehen und kann in keinen primitiven 
Typ wie die Ganzzahl O umgewandelt werden." 


Mit null lässt sich eine ganze Menge machen. Der Haupteinsatzzweck sieht vor, damit un- 
initialisierte Referenzvariablen zu kennzeichnen, also auszudrücken, dass eine Referenz- 
variable aufkein Objekt verweist. In Listen oder Bäumen kennzeichnet null zum Beispiel das 
Fehlen eines gültigen Nachfolgers oder bei einem grafischen Dialog, dass der Benutzer den 
Dialog abgebrochen hat; null ist dann ein gültiger Indikator und kein Fehlerfall. 


Hinweis 
Bei einer mit null initialisierten lokalen Variablen funktioniert die Abkürzung mit var nicht; 
es gibt einen Compilerfehler: 


12 null verhält sich also so, als ob es ein Untertyp jedes anderen Typs wäre. 
13 Hier unterscheiden sich C(++) und Java. 
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ver og: = mull, // 
8. Cannot infer type for local variable initialized to 'null' 


Auf null geht nix, nur die NullPointerException 


Da sich hinter null kein Objekt verbirgt, ist es auch nicht möglich, eine Methode aufzurufen 
oder von null eine Objektvariable zu erfragen. Der Compiler kennt zwar den Typ jedes Aus- 
drucks, aber erst die Laufzeitumgebung (JVM) weiß, was referenziert wird. Bei dem Versuch, 
über die null-Referenz auf eine Eigenschaft eines Objekts zuzugreifen, löst eine JVM eine 
NullPointerException!* aus: 


Listing 3.12 src/main/java/com/tutego/insel/oop/NullPointer.java 
package com.tutego.insel.oop; ‚1 
public class NullPointer { IFR 
public static void main( String[] args ) { // 3 
java.awt.Point p = null; // 4 
String s = null; {ES 
p.setLocation( 1, 2 ); // 6 
s.length(); //7 
} // 8 
} /19 


Wir beobachten eine NullPointerException zur Laufzeit, denn das Programm bricht bei 
p.setLocation(..) mit folgender Ausgabe ab: 


Exception in thread "main" java.lang.NullPointerException 
at com.tutego.insel.oop.NullPointer.main(NullPointer.java:6) 


Die Laufzeitumgebung teilt uns in der Fehlermeldung mit, dass sich der Fehler, die NullPoin- 
terException, in Zeile 6 befindet. Um den Fehler zu korrigieren, müssen wir entweder die 
Variablen initialisieren, das heißt, ein Objekt zuweisen wie in 

p = new java.awt.Point(); 

s= o"; 

oder vor dem Zugriff auf die Eigenschaften einen Test durchführen, ob Objektvariablen auf 
etwas zeigen oder null sind, und in Abhängigkeit vom Ausgang des Tests den Zugriff auf die 
Eigenschaft zulassen oder nicht. 


14 Der Name zeigt das Überbleibsel von Zeigern. Zwar haben wir es in Java nicht mit Zeigern zu tun, son- 
dern mit Referenzen, doch heißt es NullPointerException und nicht NullReferenceException. Das erin- 
nert daran, dass eine Referenz ein Objekt identifiziert und eine Referenz auf ein Objekt ein Pointer ist. 
Das .NET Framework ist hier konsequenter und nennt die Ausnahme NullReferenceException. 
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»null« in anderen Programmiersprachen * 


IstJava eine rein objektorientierte Programmiersprache? Nein, da Java einen Unterschied zwi- 
schen primitiven Typen und Referenztypen macht. Nehmen wir für einen Momentan, dass es 
primitive Typen nicht gäbe. Wäre Java dann eine rein objektorientierte Programmiersprache, 
bei der jede Referenz ein pures Objekt referenziert? Die Antwort ist immer noch nein, da es 
mit null etwas gibt, womit Referenzvariablen initialisiert werden können, was aber kein 
Objekt repräsentiert und keine Methoden besitzt. Und das kann bei der Dereferenzierung 
eine NullPointerException geben. 


Andere Programmiersprachen haben andere Lösungsansätze, und null-Referenzierungen 
sind nicht möglich. In der Sprache Ruby zum Beispiel ist immer alles ein Objekt. Wo Java mit 
null ein »nicht belegt« ausdrückt, macht Ruby das mit nil. Der feine Unterschied ist, dass nil 
ein Exemplar der Klasse NilClass ist, genau genommen ein Singleton, das es im System nur 
einmal gibt. nil hat auch ein paar öffentliche Methoden wie to_s (wie Javas toString()), das 
dann einen leeren String liefert. Mit nil gibt es keine NullPointerException mehr, aber 
natürlich immer noch einen Fehler, wenn auf diesem Objekt vom Typ NilClass eine Methode 
aufgerufen wird, die es nicht gibt. In Objective-C, der (bisherigen) Standardsprache für iOS- 
Programme, gibt es das Null-Objekt nil. Üblicherweise passiert nichts, wenn eine Nachricht 
an das nil-Objekt gesendet wird; die Nachricht wird einfach ignoriert." 


3.7.2 Alles auf null? Referenzen testen 


Mit dem Vergleichsoperator == oder dem Test auf Ungleichheit mit != lässt sich leicht heraus- 
finden, ob eine Referenzvariable wirklich ein Objekt referenziert oder nicht: 
if ( object == null ) 
// Variable referenziert nichts, ist aber gültig mit null initialisiert 
else 
// Variable referenziert ein Objekt 


null-Test und Kurzschluss-Operatoren 


Wir wollen an dieser Stelle noch einmal auf die üblichen logischen Kurzschluss-Operatoren 
und den logischen, nicht kurzschließenden Operator zu sprechen kommen. Erstere werten 
Operanden nur so lange von links nach rechts aus, bis das Ergebnis der Operation feststeht. 
Auf den ersten Blick scheint es nicht viel auszumachen, ob alle Teilausdrücke ausgewertet 


15 Esgibt auch Compiler wie den GCC, der mit der Option -fno-nil-receivers dieses Verhalten abschaltet, 
um schnelleren Maschinencode zu erzeugen. Denn letztendlich muss in Maschinencode immer ein Test 
stehen, der auf O prüft. 
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werden oder nicht. In einigen Ausdrücken ist dies aber wichtig, wie das folgende Beispiel für 
die Variable s vom Typ String zeigt: 


Listing 3.13 src/main/java/NullCheck.java, main 


public static void main( String[] args ) { 
String s = javax.swing.JOptionPane.showInputDialog( "Eingabe" ); 
if ( s != null 8& ! s.isEmpty() ) 
System.out.printlIn( "Eingabe: " 
else 
System.out.printIn( "Abbruch oder keine Eingabe" ); 


+S); 


} 


Die Rückgabe von showInputDialog(..) ist null, wenn der Benutzer den Dialog abbricht. Das 
soll unser Programm berücksichtigen. Daher testet die if-Bedingung, ob s überhaupt aufein 
Objekt verweist, und wenn ja, zusätzlich, ob der String nicht leer ist. Dann folgt eine Ausgabe. 


Diese Schreibweise tritt häufig auf, und der Und-Operator zur Verknüpfung muss ein Kurz- 
schluss-Operator sein, da es in diesem Fall ausdrücklich darauf ankommt, dass die Länge nur 
dann bestimmt wird, wenn die Variable s überhaupt auf ein String-Objekt verweist und nicht 
null ist. Andernfalls bekämen wir bei s.isEmpty() eine NullPointerException, wenn jeder 
Teilausdruck ausgewertet würde und s gleich null wäre. 


Das Glück der anderen: null coalescing operator * 

Da null viel zu oft vorkommt, null-Referenzierungen aber vermieden werden müssen, gibt es 
viel Code der Arto !=null ?o:non_null_o. Diverse Programmiersprachen wie JavaScript, Kot- 
lin, Objective-C, PHP oder Swift bieten für dieses Konstrukt eine Abkürzung über den soge- 
nannten null coalescing operator (coalescing heißt auf Deutsch »verschmelzend«). Er wird mal 
als ?? oder als ?: geschrieben, für unser Beispiel so: o ?? non _null_o. Besonders hübsch ist das 
bei sequenziellen Tests der Art o ?? p ?? q ?? r, wo es dann sinngemäß heißt: »Liefere die erste 
Referenz ungleich null.« Java bietet keinen solchen Operator. 


3.7.3 Zuweisungen bei Referenzen 


Eine Referenz erlaubt den Zugriff auf das referenzierte Objekt, und eine Referenzvariable 
speichert eine Referenz. Es kann durchaus mehrere Referenzvariablen geben, die die gleiche 
Referenz speichern. Das wäre so, als ob ein Objekt unter verschiedenen Namen angespro- 
chen wird - so wie eine Person von den Mitarbeitern als »Chefin« angesprochen wird, aber 
von ihrem Mann als »Schnuckiputzi«. Dies nennt sich auch Alias. 
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Beispiel 
Ein Punkt-Objekt wollen wir unter einem alternativen Variablennamen ansprechen: 
Point p = new Point(); 
Point q = p; 
Ein Punkt-Objekt wird erzeugt und mit der Variablen p referenziert. Die zweite Zeile speichert 
nun dieselbe Referenz in der Variablen q. Danach verweisen p und q auf dasselbe Objekt. Zum 


besseren Verständnis: Wichtig ist, wie oft es new gibt, denn das sagt aus, wie viele Objekte die 
JVM bildet. Und bei den zwei Zeilen gibt es nur ein new, also auch nur einen Punkt. 


Verweisen zwei Objektvariablen auf dasselbe Objekt, hat das natürlich zur Konsequenz, dass 
über zwei Wege Objektzustände ausgelesen und modifiziert werden können. Heißt die glei- 
che Person in der Firma »Chefin« und zu Hause »Schnuckiputzi«, wird der Mann sich freuen, 
wenn die Frau in der Firma keinen Stress hat. 


Wir können das Beispiel auch gut bei Punkt-Objekten nachverfolgen. Zeigen p und q auf das- 
selbe Punkt-Objekt, können Änderungen über p auch über die Variable q beobachtet werden: 


Listing 3.14 ItsTheSame.java, main 


public static void main( String[] args ) { 
Point p = new Point(); 
Point q = p; 
p.x = 10; 
System.out.printin( q.x ); // 10 
q.y = 5; 
System.out.println( p.y ); // 5 
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3.7.4 Methoden mit Referenztypen als Parameter 


Dass sich dasselbe Objekt unter zwei Namen (über zwei verschiedene Variablen) ansprechen 
lässt, können wir gut bei Methoden beobachten. Eine Methode, die über den Parameter eine 
Objektreferenz erhält, kann auf das übergebene Objekt zugreifen. Das bedeutet, die Methode 
kann dieses Objekt mit den angebotenen Methoden ändern oder auf die Objektvariablen 
zugreifen. 


Im folgenden Beispiel deklarieren wir zwei Methoden. Die erste Methode, initializeTo- 
ken(Point), soll einen Punkt mit Zufallskoordinaten initialisieren. Übergeben werden ihr 
dann zwei Point-Objekte: einmal für einen Spieler und einmal für eine Schlange. Die zweite 
Methode, printScreen(Point, Point), gibt das Spielfeld auf dem Bildschirm aus und gibt 
dann, wenn die Koordinate einen Spieler trifft, ein & aus und bei der Schlange ein S. Falls Spie- 
ler und Schlange zufälligerweise zusammentreffen, »gewinnt« die Schlange. 


Listing 3.15 src/main/java/com/tutego/insel/oop/DrawPlayerAndSnake.java 


package com.tutego.insel.oop; 
import java.awt.Point; 


public class DrawPlayerAndSnake { 


static void initializeToken( Point p ) { 
int random = (int)(Math.random() * 40); // O <= x < 40 
int randomY = (int)(Math.random() * 10); // 0 <= y < 10 
p.setLocation( randomX, randomY ); 


} 


static void printScreen( Point playerPosition, 
Point snakePosition ) { 
for (int y = 0; y < 10; y++ ) { 
for ( int x = 0; x < 40; x+ ) { 
if ( snakePosition.distanceSq( x, y ) == 0 ) 
System.out.print( 'S' ); 
else if ( playerPosition.distanceSq( x, y ) == 0 ) 
System.out.print( '&' ); 
else System.out.print( '.' ); 
} 
System.out.println(); 
} 
} 


public static void main( String|[] args ) { 
Point playerPosition = new Point(); 
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Point snakePosition = new Point(); 
System.out.printlIn( playerPosition ); 
System.out.printin( snakePosition ); 
initializeToken( playerPosition ); 
initializeToken( snakePosition ); 
System.out.println( playerPosition ); 
System.out.println( snakePosition ); 
printScreen( playerPosition, snakePosition ); 


} 
} 


Die Ausgabe kann so aussehen: 


java.awt.Point[x=0, y=0] 
java.awt.Point[x=0, y=0] 
java.awt.Point[x=38, y=1] 
java.awt.Point[x=19, y=8] 


In dem Moment, in dem main(...) die statische Methode initializeToken (Point) aufruft, gibt 
es sozusagen zwei Namen für das Point-Objekt: playerPosition und p. Allerdings ist das nur 
innerhalb der virtuellen Maschine so, denn initializeToken(Point) kennt das Objekt nur 
unter p, aber kennt die Variable playerPosition nicht. Bei main(...) ist es umgekehrt: Nur der 
Variablenname playerPosition ist in main(..) bekannt, er hat aber vom Namen p keine 
Ahnung. Die Point-Methode distanceSq(int, int) liefert den quadrierten Abstand vom aktu- 
ellen Punkt zu den übergebenen Koordinaten. 


Hinweis 

Der Name einer Parametervariablen darf durchaus mit dem Namen der Argumentvariablen 
übereinstimmen, was die Semantik nicht verändert. Die Namensräume sind völlig getrennt, 
und Missverständnisse gibt es nicht, da beide - die aufrufende Methode und die aufgerufene 
Methode — komplett getrennte lokale Variablen haben. 
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Wertübergabe und Referenzübergabe per Call by Value 

Primitive Variablen werden immer per Wert kopiert (Call by Value). Das Gleiche gilt für Refe- 
renzen, die ja als eine Art Zeiger zu verstehen sind, und das sind im Prinzip nur Ganzzahlen. 
Daher hat auch die folgende statische Methode keine Nebenwirkungen: 


Listing 3.16 JavalsAlwaysCallByValue.java 


package com.tutego.insel.oop; 
import java.awt.Point; 


public class JavalsAlwaysCallByValue { 


static void clear( Point p ) { 
System.out.println( p ); // java.awt.Point|[x=10,y=20] 
p = new Point(); 
System.out.printin( p ); // java.awt.Point|[x=0,y=0] 


} 


public static void main( String[] args ) { 
Point p = new Point( 10, 20 ); 
clear( p ); 
System.out.println( p ); // java.awt.Point[x=10,y=20] 
} 
} 


Nach der Zuweisung p = new Point() in der clear (Point )-Methode referenziert die Parameter- 
variable p ein anderes Punkt-Objekt, und der an die Methode übergebene Verweis geht damit 


verloren. Diese Änderung wird nach außen hin natürlich nicht sichtbar, denn die Parameter- 
variable p von clear(..) ist ja nur ein temporärer alternativer Name für das p aus main; eine 
Neuzuweisung an das clear-p ändert nicht den Verweis vom main-p. Das bedeutet, dass der 
Aufrufer von clear (..)-und das istmain(..) - kein neues Objekt unter sich hat. Wer den Punkt 
mit nullinitialisieren möchte, muss auf die Zustände des übergebenen Objekts direkt zugrei- 
fen, etwa so: 


static void clear( Point p ) { 
p.x = p.y = 0; 
} 


Call by Reference gibt es in Java nicht - ein Blick auf C und C++ * 


In C++ gibt es eine weitere Argumentübergabe, die sich Call by Reference nennt. Eine swap (...)- 
Funktion ist ein gutes Beispiel für die Nützlichkeit von Call by Reference: 


void swap( int& a, int& b ) { int tmp = a; a = b; b = tmp; } 
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Zeiger und Referenzen sind in C++ etwas anderes, was Spracheinsteiger leicht irritiert. Denn 
in C++ und auch in C hätte eine vergleichbare swap(..)-Funktion auch mit Zeigern implemen- 
tiert werden können: 

void swap( int *a, int *b ) { int tmp = *a; *a = *b; *b = tmp; } 


Die Implementierung gibt in C(++) einen Verweis auf das Argument. 


Final deklarierte Referenzparameter und das fehlende const 


Wir haben gesehen, dass finale Variablen dem Programmierer vorgeben, dass er Variablen 
nicht wieder beschreiben darf. Final können lokale Variablen, Parametervariablen, Objekt- 
variablen oder Klassenvariablen sein. In jedem Fall sind neue Zuweisungen tabu. Dabei ist es 
egal, ob die Parametervariable vom primitiven Typ oder vom Referenztyp ist. Bei einer 
Methodendeklaration der folgenden Art wäre also eine Zuweisung an p und auch an value 
verboten: 


public void clear( final Point p, final int value ) 


Ist die Parametervariable nicht final und ein Referenztyp, so würden wir mit einer Zuwei- 
sung den Verweis auf das ursprüngliche Objekt verlieren, und das wäre wenig sinnvoll, wie 
wir im vorangehenden Beispiel gesehen haben. final deklarierte Parametervariablen 
machen im Programmcode deutlich, dass eine Änderung der Referenzvariablen unsinnig ist, 
und der Compiler verbietet eine Zuweisung. Im Fall unserer clear (..)-Methode wäre die Ini- 
tialisierung direkt als Compilerfehler aufgefallen: 


static void clear( final Point p ) { 
p = new Point(); // & The final local variable p cannot be assigned. 


} 


Halten wir fest: Ist ein Parameter mit final deklariert, sind keine Zuweisungen möglich. 
final verbietet aber keine Änderungen an Objekten - und so könnte final im Sinne der Über- 
setzung als »endgültig« verstanden werden. Mit der Referenz des Objekts können wir sehr 
wohl den Zustand verändern, so wie wir es auch im letzten Beispielprogramm taten. 


final erfüllt demnach nicht die Aufgabe, schreibende Objektzugriffe zu verhindern. Eine 
Methode mit übergebenen Referenzen kann also Objekte verändern, wenn es etwa set*(..)- 
Methoden oder Variablen gibt, auf die zugegriffen werden kann. Die Dokumentation muss 
also immer ausdrücklich beschreiben, wann die Methode den Zustand eines Objekts modifi- 
ziert. 


In C++ gibt es für Parameter den Zusatz const, an dem der Compiler erkennen kann, dass 
Objektzustände nicht verändert werden sollen. Ein Programm nennt sich const-korrekt, 
wenn es niemals ein konstantes Objekt verändert. Dieses const ist in C++ eine Erweiterung 
des Objekttyps, die es in Java nicht gibt. Zwar haben die Java-Entwickler das Schlüsselwort 
const reserviert, doch genutzt wird es bisher nicht. 
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3.7.5 Identität von Objekten 


Die Vergleichsoperatoren == und != sind für alle Datentypen so definiert, dass sie die voll- 
ständige Übereinstimmung zweier Werte testen. Bei primitiven Datentypen ist das einfach 
einzusehen und bei Referenztypen im Prinzip genauso (zur Erinnerung: Referenzen lassen 
sich als Pointer verstehen, was Ganzzahlen sind). Der Operator == testet bei Referenzen, ob 
sie übereinstimmen, also auf dasselbe Objekt verweisen. Der Operator != testet das Gegen- 
teil, also ob sie nicht übereinstimmen, die Referenzen somit ungleich sind. Demnach sagt der 
Test etwas über die Identität der referenzierten Objekte aus, aber nichts darüber, ob zwei ver- 
schiedene Objekte möglicherweise den gleichen Inhalt haben. Der Inhalt der Objekte spielt 
bei == und != keine Rolle. 


Beispiel 
Zwei Objekte mit drei unterschiedlichen Punktvariablen p, q, r und die Bedeutung von ==: 
Point p = new Point( 10, 10 ); 
Point q = p; 
Point r = new Point( 10, 10 ); 
System.out.printin( p == q ); // true, da p und q dasselbe Objekt referenzieren 
System.out.printin( p == r ); // false, da p und r zwei verschiedene Punkt- 
// Objekte referenzieren, die zufällig dieselben 
// Koordinaten haben 


Da p und q auf dasselbe Objekt verweisen, ergibt der Vergleich true. p und r referenzieren 
unterschiedliche Objekte, die aber zufälligerweise den gleichen Inhalt haben. Doch woher 
soll der Compiler wissen, wann zwei Punkt-Objekte inhaltlich gleich sind? Weil sich ein Punkt 
durch die Objektvariablen x und y auszeichnet? Die Laufzeitumgebung könnte voreilig die 
Belegung jeder Objektvariablen vergleichen, doch das entspricht nicht immer einem korrek- 
ten Vergleich, so wie wir ihn uns wünschen. Ein Punkt-Objekt könnte etwa zusätzlich die 
Anzahl der Zugriffe zählen, die jedoch für einen Vergleich, der auf der Lage zweier Punkte 
basiert, nicht berücksichtigt werden darf. 


3.7.6 Gleichwertigkeit und die Methode equals(...) 


Die allgemeingültige Lösung besteht darin, die Klasse festlegen zu lassen, wann Objekte 
gleich(wertig) sind. Dazu kann jede Klasse eine Methode equals (..) implementieren, und mit 
ihrer Hilfe kann sich jedes Exemplar dieser Klasse mit beliebigen anderen Objekten ver- 
gleichen. Die Klassen entscheiden immer nach Anwendungsfall, welche Objektvariablen sie 
für einen Gleichheitstest heranziehen, und equals(..) liefert true, wenn die gewünschten 
Zustände (Objektvariablen) übereinstimmen. 
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Beispiel 
Zwei nicht identische, inhaltlich gleiche Punkt-Objekte werden mit == und equals(...) ver- 
glichen: 


Point p = new Point( 10, 10 ); 

Point q = new Point( 10, 10 ); 

System.out.println( p == q ); // false 

System.out.printin( p.equals(q) ); // true, da symmetrisch auch q.equals(p) 


Nur equals (...) testet in diesem Fall die inhaltliche Gleichwertigkeit. 


Bei den unterschiedlichen Bedeutungen müssen wir demnach die Begriffe Identität und 
Gleichwertigkeit (auch Gleichheit) von Objekten sorgfältig unterscheiden. Daher zeigt Tabelle 
3.4 noch einmal eine Zusammenfassung: 


getestet mit Implementierung 
Identität der Referenzen == bzw. l= nichts zu tun 


Gleichwertigkeit der Zustände equals(..) bzw. ! equals (...) abhängig von der Klasse 


Tabelle 3.4 Identität und Gleichwertigkeit von Objekten 


equals(...)-Implementierung von Point * 
Die Klasse Point deklariert equals(..), wie die API-Dokumentation zeigt. Werfen wir einen 
Blick auf die Implementierung, um eine Vorstellung von der Arbeitsweise zu bekommen: 


Listing 3.17 java/awt/Point.java, Ausschnitt 
public class Point ... { 


public int x; 
public int y; 


public boolean equals( Object obj ) { 


Point pt = (Point) obj; 
return (x == pt.x) && (y == pt.y); // (®) 


} 
} 


Obwohl bei diesem Beispiel für uns einiges neu ist, erkennen wir den Vergleich in der Zeile 
(*). Hier vergleicht das Point-Objekt seine eigenen Objektvariablen mit den Objektvariablen 
des Punktobjekts, das als Argument an equals (..) übergeben wurde. 
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3.8 Zum Weiterlesen 


Es gibt immer ein equals(...) — die Oberklasse Object und ihr equals(...) * 


Glücklicherweise müssen wir als Programmierer nicht lange darüber nachdenken, ob eine 
Klasse eine equals(..)-Methode anbieten soll oder nicht. Jede Klasse besitzt sie, da die univer- 
selle Oberklasse Object sie vererbt. Wir greifen hier auf Kapitel 7, »Objektorientierte Bezie- 
hungsfragen«, vor; der Abschnitt kann aber übersprungen werden. Wenn eine Klasse also 
keine eigene equals(..)-Methode angibt, dann erbt sie eine Implementierung aus der Klasse 
Object. Diese Klasse sieht wie folgt aus: 


Listing 3.18 java/lang/Object.java, Ausschnitt 
public class Object { 
public boolean equals( Object obj ) { 
return ( this == obj ); 
} 


} 


Wir erkennen, dass hier die Gleichwertigkeit auf die Identität der Referenzen abgebildet wird. 
Ein inhaltlicher Vergleich findet nicht statt. Das ist das Einzige, was die vorgegebene Imple- 
mentierung machen kann, denn sind die Referenzen identisch, sind die Objekte logischer- 
weise auch gleich. Nur über Zustände »weiß« die Basisklasse Object nichts. 


Sprachvergleich 

Es gibt Programmiersprachen, die für den Identitätsvergleich und Gleichwertigkeitstest 
eigene Operatoren anbieten. Was bei Java == und equals (...) sind, sind bei Python is und ==, 
bei Swift === und ==. 


3.8 Zum Weiterlesen 


In diesem Kapitel wurde das Thema Objektorientierung recht schnell eingeführt, was nicht 
bedeuten soll, dass OOP einfach ist. Der Weg zu gutem Design ist steinig und führt nur über 
viele Java-Projekte. Hilfreich sind das Lesen von fremden Programmen und die Beschäfti- 
gung mit Entwurfsmustern. Rund um UML ist ebenfalls eine Reihe von Produkten entstan- 
den. Das Angebot beginnt bei einfachen Zeichenwerkzeugen, geht über UML-Tools mit 
Roundtrip-Fähigkeit und reicht bis zu kompletten CASE-Tools mit MDA-Fähigkeit. 


Kapitel 16 
Die Klassenbibliothek 


»Was wir brauchen, sind ein paar verrückte Leute; 
seht euch an, wohin uns die normalen gebracht haben.« 
— George Bernard Shaw (1856-1950) 


16.1 Die Java-Klassenphilosophie 


Eine Programmiersprache besteht nicht nur aus einer Grammatik, sondern, wie im Fall von 
Java, auch aus einer Programmierbibliothek. Eine plattformunabhängige Sprache - so wie 
sich viele C oder C++ vorstellen - ist nicht wirklich plattformunabhängig, wenn auf jedem 
Rechner andere Funktionen und Programmiermodelle eingesetzt werden. Genau dies ist der 
Schwachpunkt von C(++). Die Algorithmen, die kaum vom Betriebssystem abhängig sind, las- 
sen sich überall gleich anwenden, doch spätestens bei der Ein-/Ausgabe oder grafischen 
Oberflächen ist Schluss. Die Java-Bibliothek dagegen versucht, von den plattformspezi- 
fischen Eigenschaften zu abstrahieren, und die Entwickler haben sich große Mühe gegeben, 
alle wichtigen Methoden in wohlgeformten objektorientierten Klassen und Paketen unter- 
zubringen. Diese decken insbesondere die zentralen Bereiche Datenstrukturen, Ein- und 
Ausgabe, Grafik- und Netzwerkprogrammierung ab. 


16.1.1 Modul, Paket, Typ 


An oberster Stelle der Java-Bibliothek stehen Module. Sie wiederum bestehen aus Paketen, 
die wiederum die Typen enthalten. 
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Module der Java SE 


Die API der Java Platform, Standard Edition (»Java SE«) besteht aus folgenden Modulen, die 
alle mit dem Präfix java beginnen. 


Das java.base-Modul ist das wichtigste Modul, und es enthält Kernklassen wie Object und 
String usw. Es ist das einzige Modul, das selbst keine Abhängigkeit zu anderen Modulen ent- 
hält. Jedes andere Modul jedoch bezieht sich mindestens auf java. base. Die Javadoc stellt das 
schön grafisch dar (siehe Abbildung 16.1). 


Modul Beschreibung 


java.xml 


java.base 


fundamentale Typen der Java SE-Plattform 


java.compiler Java-Sprachmodell, Annotationsverarbeitung, Java-Compiler-API 


java.base 


java.datatransfer 


.desktop 


„instrument 


. logging 
.management 
.management.rmi 
.naming 


.prefs 


.rmi 
.scripting 
.security.jgss 


.security.sasl 


-sql 
.sql.rowset 


‚xml 


API für den Datentransfer zwischen Applikationen, in der Regel die 
Zwischenablage 


grafische Oberflächen mit AWT und Swing, Accessibility-API, Audio, 
Drucken und JavaBeans 


Instrumentalisierung ist die Veränderung der Java-Programme zur 
Laufzeit. 


Logging-API 

Java Management Extensions (JMX) 

RMI-Connector für den Remote-Zugriff auf die JMX-Beans 
Java Naming and Directory Interface-(JNDI-)API 


Die Preferences-AP| dient zum Speichern von Benutzereinstel- 
lungen. 


entfernte Methodenaufrufe; Remote Method Invocation-(RMI-)API 
Scripting-API 
Java-Binding der IETF Generic Security Services-API (GSS-API) 


Java-Unterstützung für IETF Simple Authentication and Security 
Layer (SASL) 


JDBC-API für den Zugriff auf relationale Datenbanken 
JDBC RowSet-API 


XML-Klassen: Java API for XML Processing (JAXP), Streaming API for 
XML (StAX), Simple API for XML (SAX), W3C Document Object Model- 
(DOM-)API 


Abbildung 16.1 Das Modul »java.xml« hat eine Abhängigkeit zum »java.base«-Modul. 


Zum Teil gibt es mehr Abhängigkeiten, etwa beim Modul java.desktop, wie Abbildung 16.2 


demonstriert: 


java.desktop 


java.xml 


java.datatransfer 


java.base 


Abbildung 16.2 Abhängigkeiten des Moduls »java.desktop« 


Das Modul java.se 


Ein besonderes Modul ist java.se. Es deklariert selbst keine eigenen Pakete oder Typen, son- 


dern fasst lediglich andere Module zusammen. Der Name für so eine Konstruktion ist Aggre- 
gator-Modul. Das java.se-Modul definiert auf diese Weise die API für die Java SE-Plattform 
(siehe Abbildung 16.3). 
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java.xml.crypto API für XML-Kryptografie 


Abbildung 16.3 Abhängigkeiten des Moduls »java.se« 
Tabelle 16.1 Module der Java SE 
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Hinweis 


Wir werden im Folgenden bei den Java SE-Typen nicht darauf eingehen, aus welchem Modul 
sie stammen. Es ist nur dann wichtig zu wissen, in welchem Modul sich ein Typ befindet, 
wenn kleinere Teilmengen der Java SE gebaut werden. 


Weitere Module 


Zwei weitere Module, die ebenfalls mit java beginnen, aber nicht zum Java SE-Standard zäh- 
len, sind java.jnlp (Java Network Launch Protocol) und java.smartcardio (Java-API für die 
Kommunikation mit Smart Cards nach ISO/IEC 7816-4). 


Das JDK ist die Standardimplementierung der Java SE. Es liefert den Entwicklern weitere 


Pakete und Klassen, etwa mit einem HTTP-Server oder den Java-Werkzeugen wie dem 
Java-Compiler und dem Javadoc-Tool. Es gibt mehrere Module, die alle mit dem Präfix jdk 


beginnen. 


Hinweis 


Oracle hat aus Java 11 diverse Teile entfernt, etwa JavaFX oder Java EE-Module. Entwickler bin- 
den am besten die Referenzimplementierungen ein, https://stackoverflow.com/questions/ 
48204141/replacements-for-deprecated-jpms-modules-with-java-ee-apis dokumentiert das. 
JavaFX war nie ein Teil des Java SE-Standards, sondern eine »Beigabe« des Oracle JDK. Die 
Alternative ist, OpenJFX einzubinden. 


16.1.2 Übersicht über die Pakete der Standardbibliothek 


Die Java 11 Core Java SE API besteht aus folgenden Modulen und Paketen - eine Kurzbeschrei- 
bung findet sich im Anhang: 


Module 


java.base 


enthaltene Pakete 


.io, java.lang, java.lang.annotation, java.lang.invoke, 
.lang.module, java.lang.ref, java.lang.reflect, java.math, 
.net, java.net.spi, java.nio, java.nio.channels, 
.nio.channels.spi, java.nio.charset, java.nio.charset.spi, 
.nio.file, java.nio.file.attribute, java.nio.file.spi, 
„security, java.security.cert, java.security.interfaces, 
.security.spec, java.text, java.text.spi, java.time, 
.time.chrono, java.time. format, java.time.temporal, 
.time.zone, java.util, java.util.concurrent, 
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Module 


java.base (Forts.) 


java.compiler 


java.datatransfer 


java.desktop 


java.instrument 
java.logging 


java.management 
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enthaltene Pakete 


java.util.concurrent.atomic, java.util.concurrent.locks, 
java.util.function, java.util.jar, java.util.regex 
java.util.spi, java.util.stream, java.util.zip, javax.crypto, 
javax.crypto.interfaces, javax.crypto.spec, javax.net, 
javax.net.ssl, javax.security.auth, javax.security.auth.call- 
ack, javax.security.auth.login, javax.security.auth.spi, 
javax.security.auth.x500, javax.security.cert 


javax.annotation.processing, javax.lang.model, 
javax.lang.model.element, javax.lang.model.type, 
javax.lang.model.util, javax.tools 


java.awt.datatransfer 


java.applet, java.awt, java.awt.color, java.awt.desktop, 
java.awt.dnd, java.awt.event, java.awt.font, java.awt.geom, 
java.awt.im, java.awt.im.spi, java.awt.image, 
java.awt.image.renderable, java.awt.print, java.beans, 
java.beans.beancontext, javax.accessibility, javax.imageio 
javax.imageio.event, javax.imageio.metadata 
javax.imageio.plugins.bmp, javax.imageio.plugins.jpeg, 
javax.imageio.plugins.tiff, javax.imageio.spi, 
javax.imageio.stream, javax.print, javax.print.attribute 
javax.print.attribute.standard, javax.print.event 
javax.sound.midi, javax.sound.midi.spi, javax.sound.sampled, 
javax.sound.sampled.spi, javax.swing, javax.swing.border 
javax.swing.colorchooser, javax.swing.event 
javax.swing.filechooser, javax.swing.plaf, 
javax.swing.plaf.basic, javax.swing.plaf.metal, 
javax.swing.plaf.multi, javax.swing.plaf.nimbus 
javax.swing.plaf.synth, javax.swing.table, javax.swing.text, 
javax.swing.text.html, javax.swing.text.html.parser 
javax.swing.text.rtf, javax.swing.tree, javax.swing.undo 


java.lang.instrument 
java.util.logging 


java.lang.management, javax.management, javax.management.1loa- 
ding, javax.management.modelmbean, javax.management.monitor, 

javax.management.openmbean, javax.management.relation, 
javax.management.remote, javax.management.timer 


Tabelle 16.2 Übersicht über die Pakete in den Modulen der Java 17 Core Java SE API (Forts.) 
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Module enthaltene Pakete 
java.management.rmi javax.management.remote.rmi 


java.naming javax.naming, javax.naming.directory, javax.naming.event 
javax.naming.ldapjavax.naming.spi 


.prefs java.util.prefs 


.rmi java.rmi, java.rmi.activation, java.rmi.dgc, java.rmi.registry, 
java.rmi.server, javax.rmi.ssl 


.scripting javax.script 

.security.jgss javax.security.auth.kerberos, org.ietf.jgss 
.security.sasl javax.security.sasl 

-sql java.sql, javax.sql, javax.transaction.xa 


.sql.rowset javax.sql.rowset, javax.sql.rowset.serial, javax.sql.row- 
set.spi 


xml javax.xml, javax.xml.catalog, javax.xml.datatype, 
javax.xmL.namespace, javax.xml.parsersjavax.xml.stream, 


javax.xml.stream.events, javax.xml.stream.util, 


javax.xml.transform.sax, javax.xml.transform.stax, 
javax.xml.transform.stream, javax.xml.validation, 
javax.xml.xpath, org.w3c.dom, org.w3c.dom.bootstrap, 
org.w3c.dom.events, org.w3c.dom.1s, org.w3c.dom.ranges, 
org.w3c.dom. views, org.xml.sax, org.xml.sax.ext, 
org.xml.sax.helpers 


javax.xml.transform, javax.xml.transform.dom, 


java.xml.crypto javax.xml.crypto, javax.xml.crypto.dom, javax.xml.crypto.dsig, 
javax.xml.crypto.dsig.dom, javax.xml.crypto.dsig.keyinfo, 
javax.xml.crypto.dsig.spec 


Tabelle 16.2 Übersicht über die Pakete in den Modulen der Java 17 Core Java SE API (Forts.) 


Entwickler sollten folgende Pakete von ihren Möglichkeiten her zuordnen können: 


Beschreibung 


java.awt Das Paket AWT (Abstract Windowing Toolkit) bietet Klassen zur Gra- 
fikausgabe und zur Nutzung von grafischen Bedienoberflächen. 


Tabelle 16.3 Wichtige Pakete in der Java SE 


16.1 Die Java-Klassenphilosophie 


Paket Beschreibung 


java.awt.event Schnittstellen für die verschiedenen Ereignisse unter grafischen 
Oberflächen 


Möglichkeiten zur Ein- und Ausgabe. Dateien werden als Objekte 
repräsentiert. Datenströme erlauben den sequenziellen Zugriff auf 
die Dateiinhalte. 


Ein Paket, das automatisch eingebunden ist. Enthält unverzichtbare 
Klassen wie String-, Thread- oder Wrapper-Klassen. 


Kommunikation über Netzwerke. Bietet Klassen zum Aufbau von 
Client- und Serversystemen, die sich über TCP bzw. IP mit dem Inter- 
net verbinden lassen. 


Unterstützung für internationalisierte Programme. Bietet Klassen 
zur Behandlung von Text und zur Formatierung von Datumswerten 
und Zahlen. 


Bietet Typen für Datenstrukturen, Raum und Zeit sowie für Teile der 
Internationalisierung sowie für Zufallszahlen. Unterpakete küm- 
mern sich um reguläre Ausdrücke und Nebenläufigkeit. 


javax.swing Swing-Komponenten für grafische Oberflächen. Das Paket besitzt 
diverse Unterpakete. 
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Eine vollständige Übersicht aller Pakete gibt der Anhang, »Java SE-Module und Paketüber- 
sicht«. Als Entwickler ist es unumgänglich, für die Details die Java-API-Dokumentation unter 
https://docs.oracle.com/en/java/javase/17/docs/api/index.html zu studieren. 


Offizielle Schnittstelle (java- und javax-Pakete) 

Das, was die Java-Dokumentation aufführt, bildet den erlaubten Zugang zur Bibliothek. Die 
Typen sind im Grunde für die Ewigkeit ausgelegt, sodass Entwickler darauf zählen können, 
auch noch in 100 Jahren ihre Java-Programme ausführen zu können. Doch wer definiert die 
API? Im Kern sind es vier Quellen: 

> Oracle-Entwickler setzen neue Pakete und Typen in die API. 


> Der Java Community Process (JCP) beschließt eine neue API. Dann ist es nicht nur Oracle 
allein, sondern eine Gruppe, die eine neue API erarbeitet und die Schnittstellen definiert. 


Die Object Management Group (OMG) definiert eine API für CORBA. 
Das World Wide Web Consortium (W3C) gibt eine API etwa für X<ML-DOM vor. 
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Die Merkhilfe ist, dass alles, was mit java oder javax beginnt, eine erlaubte API darstellt und 
alles andere zu nicht portablen Java-Programmen führen kann. Es gibt außerdem Klassen, 
die unterstützt werden, aber nicht Teil der offiziellen API sind. Dazu zählen etwa diverse 
Swing-Klassen für das Aussehen der Oberfläche. 


Standard Extension API (javax-Pakete) 


Einige der Java-Pakete beginnen mit javax. Dies sind ursprünglich Erweiterungspakete 
(Extensions), die die Kernklassen ergänzen sollten. Im Laufe der Zeitsind jedoch viele der frü- 
her zusätzlich einzubindenden Pakete in die Standarddistribution gewandert, sodass heute 
ein recht großer Anteil mit javax beginnt, aber keine Erweiterungen mehr darstellt, die 
zusätzlich installiert werden müssen. Sun wollte damals die Pakete nicht umbenennen, um 
so eine Migration nicht zu erschweren. Fällt heute im Quellcode ein Paketname mit javax 
auf, ist es daher nicht mehr so einfach, zu entscheiden, ob eine externe Quelle mit eingebun- 
den werden muss oder ab welcher Java-Version das Paket Teil der Distribution ist. Echte 
externe Pakete sind unter anderem: 

> die Enterprise/Server API mit den Enterprise JavaBeans, Servlets und JavaServer Faces 


> die Java Persistence API (JPA) zum dauerhaften Abbilden von Objekten auf (in der Regel) 
relationale Datenbanken 


die Java Communications API für serielle und parallele Schnittstellen 

die Java Telephony API 

die Spracheingabe/-ausgabe mit der Java Speech API 

JavaSpaces für gemeinsamen Speicher unterschiedlicher Laufzeitumgebungen 


JXTA zum Aufbau von P2P-Netzwerken 


Im Endeffekt haben Entwickler es mit folgenden Bibliotheken zu tun: 
1. mit der offiziellen Java-API 
2. mit der API aus JSR-Erweiterungen, wie der Java-Enterprise-API 


3. mit nichtoffiziellen Bibliotheken, wie quelloffenen Lösungen, etwa zum Zugriff auf PDF- 
Dateien oder Bankautomaten 


16.2 Einfache Zeitmessung und Profiling * 


Neben den komfortablen Klassen zum Verwalten von Datumswerten gibt es mit zwei stati- 
schen Methoden einfache Möglichkeiten, Zeiten für Programmabschnitte zu messen: 


final class java.lang.System 


16.2 Einfache Zeitmessung und Profiling * 


= static long currentTimeMillis() 
Gibt die seit dem 1.1.1970, 00:00:00 UTC vergangenen Millisekunden zurück. 
= static long nanoTime() 


Liefert die Zeit vom genauesten System-Zeitgeber. Sie hat keinen Bezugspunkt zu irgend- 
einem Datum. 


Die Differenz zweier Zeitwerte kann zur groben Abschätzung der Ausführungszeiten von 
Programmen dienen: 


Listing 16.1 com/tutego/insel/lang/Profiling.java 


package com.tutego.insel.lang; 


import static java.util.concurrent.TimeUnit.NANOSECONDS; 
import java.util.Arrays; 

import java.util.function.Supplier; 

import java.util.function.ToLongFunction; 


class Profiling { 


final static String ANGIE = 
"Aber Angie, Angie, ist es nicht an der Zeit, Goodbye zu sagen? " + 


"Ohne Liebe in unseren Seelen und ohne Geld in unseren Mänteln. 
"Du kannst nicht sagen, dass wir zufrieden sind."; 


final static int MAX = 10000; 


enum Algorithm { 
STRING BUILDER1( () -> { // StringBuffer(size) und append() zur Konkatenation 
StringBuilder sb = new StringBuilder( 2 * MAX * ANGIE.length() ); 
for (int i = MX; i-- > 0; ) 
sb.append( ANGIE ).append( ANGIE ); 
return sb.toString().length(); 
>)’ 
STRING BUILDER2( () -> { // StringBuffer und append() zur Konkatenation 
StringBuilder sb = new StringBuilder(); 
for ( int i = MAX; i-- > 0; ) 
sb.append( ANGIE ).append( ANGIE ); 
return sb.toString().length(); 


J) 
STRING _PLUS( () -> { // + zur Konkatenation 


String s = ""; 
for ( int i = MAX; i-- > 0; ) 
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s += ANGIE + ANGIE; 
return s.length(); 
p) 


private final Supplier<Integer> supplier; 
private Algorithm( Supplier<Integer> supplier ) { this.supplier = supplier; } 
int perform() { return supplier.get(); } 

} 


private static long[] measure() { 
ToLongFunction<Algorithm> duration = algorithm -> { 
long startTime = System.nanoTime(); 
int result = algorithm.perform(); 
try { return NANOSECONDS.toMillis( System.nanoTime() - startTime ); } 
finally { System.out.println( result ); } 
}; 
return Arrays.stream( Algorithm.values() ).mapToLong( duration ).toArray(); 
} 


public static void main( String[] args ) { 
measure(); System.gc(); measure(); System.gc(); 
long[] durations = measure(); 


System.out.printf( "sb(size), append(): %d ms%n", durations[0] ); 
// sb(size), append(): 6 ms 

System.out.printf( "sb(), append() : %d ms%n", durations[1] ); 
// sb(), append() : 9 ms 

System.out.printf( "t+= : %d ms%n", durations[2] ); 
// t+= : 15982 ms 

} 
} 


Das Testprogramm hängt Zeichenfolgen mit 


>» einem StringBuilder, der nicht in der Endgröße initialisiert ist, 
> einem StringBuilder, der eine vorinitialisierte Endgröße nutzt, und 


>» dem Plus-Operator von Strings zusammen. 


Vor der Messung gibt es zwei Testläufe und ein System.gc(), das die automatische Speicher- 
bereinigung (GC) anweist, Speicher freizugeben. (Das würde in gewöhnlichen Programmen 
nicht stehen, da der Garbage-Collector schon selbst ganz gut weiß, wann Speicher freizuge- 
ben ist. Nur kostet das Freigeben auch Ausführungszeit, und es würde die Messzeiten beein- 
flussen, was wir hier nicht wollen.) 


16.3 Die Klasse Class 


Auf meinem Rechner (JDK 10) liefert das Programm diese Ausgabe: 


sb(size), append(): 7 ms 
sb(), append() :9 ms 
t+= : 15982 ms 


Das Ergebnis: Beigroßen Anhängeoperationen ist es nur unwesentlich besser, einen passend 


in der Größe initialisierten StringBuilder zu benutzen. Über das + entstehen viele temporäre 


Objekte, was wirklich teuer kommt. Da in Java 9 die Konkatenation von Strings über den 
Plus-Operator beschleunigt wurde, sind die Zeiten besser als unter Java 8, wo die Ausfüh- 
rungszeit bei 41.262 ms liegt. 


Tipp 

Die Werte von nanoTime() sind immer aufsteigend, was für currentTimeMillis() nicht zwin- 
gend gelten muss, da sich Java die Zeit vom Betriebssystem holt, und da kann sich die System- 
zeit ändern, etwa wenn der Benutzer die Zeit anpasst. Differenzen von current TimeMillis()- 
Zeitstempeln sind dann komplett falsch und könnten sogar negativ sein. 


Profiler 


Wo die JVM im Programm überhaupt Taktzyklen verschwendet, zeigt ein Profiler. An diesen 
Stellen kann dann mit der Optimierung begonnen werden. Java Mission Control ist ein leis- 
tungsfähiges Programm des JDK und integriert einen freien Profiler. Java VisualVM ist ein 
weiteres freies Programm, dass unter https;//visualvm.github.io/ bezogen werden kann. Auf 
der professionellen und kommerziellen Seite stehen sich JProfiler (https://www.ej-technolo- 
gies.com/products/jprofiler/overview.html) und Yourkit (https://www.yourkit.com/java/pro- 
filer) gegenüber. Die Ultimate Version von Intellij enthält ebenfalls einen Profiler. 


16.3 Die Klasse Class 


Angenommen, wir wollen einen Klassen-Browser schreiben. Dieser soll alle zum laufenden 
Programm gehörenden Klassen und darüber hinaus weitere Informationen anzeigen, wie 
etwa Variablenbelegung, deklarierte Methoden, Konstruktoren und Informationen über die 
Vererbungshierarchie. Dafür benötigen wir die Bibliotheksklasse Class. Exemplare der Klasse 
Class sind Objekte, die entweder eine Java-Klasse oder Java-Schnittstelle repräsentieren. 
(Dass auch Schnittstellen durch Class-Objekte repräsentiert werden, wird im Folgenden 
nicht mehr ausführlich erwähnt.) 


In diesem Punkt unterscheidet sich Java von vielen herkömmlichen Programmiersprachen, 
da sich Eigenschaften von Klassen vom gerade laufenden Programm mithilfe der Class- 
Objekte abfragen lassen. Bei den Exemplaren von Class handelt es sich um eine einge- 
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schränkte Form von Meta-Objekten! - die Beschreibung eines Java-Typs, die aber nur ausge- 
wählte Informationen preisgibt. Neben normalen Klassen werden auch Schnittstellen durch 
ein Class-Objekt repräsentiert, und sogar Arrays und primitive Datentypen - statt Class wäre 
wohl der Klassenname Type passender gewesen. 


16.3.1 An ein Class-Objekt kommen 


Zunächst müssen wir für eine bestimmte Klasse das zugehörige Class-Objekt in Erfahrung 
bringen. Class-Objekte selbst kann nur die JVM erzeugen. Wir können das nicht (die Objekte 
sind immutable, und der Konstruktor ist privat). Um einen Verweis auf ein Class-Objekt zu 
bekommen, bieten sich folgende Lösungen an: 


> Ist ein Exemplar der Klasse verfügbar, rufen wir die getClass()-Methode des Objekts auf 
und erhalten das Class-Exemplar der zugehörigen Klasse. 


Jeder Typ enthält eine statische Variable mit dem Namen .class vom Typ Class, die auf 
das zugehörige Class-Exemplar verweist. 


Auch auf primitiven Datentypen ist das Ende .class erlaubt. Das gleiche Class-Objekt lie- 
fert die statische Variable TYPE der Wrapper-Klassen. Damit ist int.class == Integer.TYPE. 


Die Klassenmethode Class. forName(String) kann eine Klasse erfragen, und wir erhalten 
das zugehörige Class-Exemplar als Ergebnis. Ist der Typ noch nicht geladen, sucht und 
bindet forName(String) die Klasse ein. Weil das Suchen schiefgehen kann, ist eine Class- 
NotFoundException möglich. 


Haben wir bereits ein Class-Objekt, sind aber nicht an ihm, sondern an seinen Vorfahren 
interessiert, so können wir einfach mit getSuperclass() ein Class-Objekt für die Ober- 
klasse erhalten. 


Das folgende Beispiel zeigt drei Möglichkeiten auf, an ein Class-Objekt für java.util.Date 
heranzukommen: 


Listing 16.2 src/main/java/com/tutego/insel/meta/GetClassObject.java, main() 


Class<Date> c1 = java.util.Date.class; 
System.out.printin( c1 ); // class java.util.Date 
Class<?> c2 = new java.util.Date().getClass(); 

// oder Class<? extends Date c2 =... 


System.out.println( c2 ); // class java.util.Date 


try { 
Class<?> c3 = Class.forName( "java.util.Date" ); 


1 Echte Metaklassen wären Klassen, deren jeweils einziges Exemplar die normale Java-Klasse ist. Dann 
wären etwa die normalen Klassenvariablen in Wahrheit Objektvariablen in der Metaklasse. 
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System.out.printin( c3 ); // class java.util.Date 


} 
catch ( ClassNotFoundException e ) { e.printStackTrace(); } 


Die Variante mit forName(String) ist sinnvoll, wenn der Name der gewünschten Klasse bei 
der Übersetzung des Programms noch nicht feststand. Sonst ist die vorhergehende Technik 
eingängiger, und der Compiler kann prüfen, ob es den Typ gibt. Eine volle Qualifizierung ist 
nötig, Class. forName("Date") würde nur nach Date in dem Default-Paket suchen - die Rück- 
gabe ist ja keine Sammlung. 


Beispiel 

Klassenobjekte für primitive Elemente liefert forName(String) nicht! Die beiden Anweisun- 
gen Class. forName("boolean") und Class. forName(boolean.class.getName()) führen zu 
einer ClassNotFoundException. 


class java.lang.Object 


m final Class<? extends Object> getClass() 
Liefert zur Laufzeit das Class-Exemplar, das die Klasse des Objekts repräsentiert. 


final class java.lang.Class<T> 
implements Serializable, GenericDeclaration, Type, AnnotatedElement 


m static Class<?> forName (String className) throws ClassNotFoundException 

Liefert das Class-Exemplar für die Klasse oder Schnittstelle mit dem angegebenen voll 
qualifizierten Namen. Falls sie bisher noch nicht vom Programm benötigt wurde, sucht 
und lädt der Klassenlader die Klasse. Die Methode liefert niemals null zurück. Falls die 
Klasse nicht geladen und eingebunden werden konnte, gibt es eine ClassNotFoundExcep- 
tion. Eine alternative Methode forName (String name, boolean initialize, ClassLoader loa- 
der) ermöglicht auch das Laden mit einem gewünschten Klassenlader. Der Klassenname 
muss immer voll qualifiziert sein. 


ClassNotFoundException und NoClassDefFoundError * 

Eine ClassNotFoundException lösen die Methoden 

>» forName(..) aus Class und 

> loadClass (String name |, boolean resolve]) aus ClassLoader bzw. 

> findSystemClass (String name) aus ClassLoader 

immer dann aus, wenn der Klassenlader die Klasse nach ihrem Klassennamen nicht finden 


kann. Auslöser ist also die Anwendung, die dynamisch Typen laden will, die dann aber nicht 
vorhanden sind. 
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Neben der Exception-Klasse gibt es einen NoClassDefFoundError - ein harter LinkageError, 
den die JVM immer dann auslöst, wenn sie eine im Bytecode referenzierte Klasse nicht laden 
kann. Nehmen wir zum Beispiel eine Anweisung wie new MeineKlasse(). Führt die JVM diese 
Anweisung aus, versucht sie, den Bytecode von MeineKlasse zu laden. Ist der Bytecode für 
MeineKlasse nach dem Compilieren entfernt worden, löst die JVM durch den nicht geglück- 
ten Ladeversuch den NoClassDefFoundError aus. Auch tritt der Fehler auf, wenn beim Laden 
des Bytecodes die Klasse MeineKlasse zwar gefunden wurde, aber MeineKlasse einen stati- 
schen Initialisierungsblock besitzt, der wiederum eine Klasse referenziert, für die keine Klas- 
sendatei vorhanden ist. 


Während ClassNotFoundException häufiger vorkommt als NoClassDefFoundError, ist die Aus- 
nahme im Allgemeinen ein Indiz dafür, dass ein Java-Archiv im Modulpfad fehlt. 


Probleme nach Anwendung eines Obfuscators * 


Dass der Compiler automatisch Bytecode gemäß diesem veränderten Quellcode erzeugt, 
führt nur dann zu unerwarteten Problemen, wenn wir einen Obfuscator über den Pro- 
grammtext laufen lassen, der nachträglich den Bytecode modifiziert und damit die Bedeu- 
tung des Programms bzw. des Bytecodes verschleiert und dabei Typen umbenennt. Offen- 
sichtlich darf ein Obfuscator Typen, deren Class-Exemplare abgefragt werden, nicht umbe- 
nennen - oder der Obfuscator müsste die entsprechenden Zeichenketten ebenfalls korrekt 
ersetzen (aber natürlich nicht alle Zeichenketten, die zufällig mit Namen von Klassen über- 
einstimmen). 


16.3.2 Eine Class ist ein Type 


In Java gibt es unterschiedliche Typen, wobei Klassen, Schnittstellen und Aufzählungstypen 
von der JVM als Class-Objekte repräsentiert werden. In der Reflection-API repräsentiert die 
Schnittstelle Type alle Typen. Das ist bisher die implementierende Klasse Class, und dazu 
kommen einige Unterschnittstellen: 

ParameterizedType (repräsentiert generische Typen wie List<T>) 

TypeVariable<D> (repräsentiert beispielsweise T extends Comparable<? super T>) 

WildcardType (repräsentiert etwa ? super T) 


GenericArrayType (repräsentiert so etwas wie T[]) 


Die einzige Methode von Type ist getTypeName(), und das ist sogar »nur« eine Default- 
Methode, die toString() aufruft. 


Type ist die Rückgabe diverser Methoden in der Reflection-API, etwa von getGenericSuper- 
class() und getGenericInterfaces() der Klasse Class und von vielen weiteren Methoden, die 
die Javadoc unter »USE« aufzählt. 


16.4 Klassenlader 


16.4 Klassenlader 


In Java ist eine Kaskade von unterschiedlichen Klassenladern für das Laden von Klassen ver- 
antwortlich. Bei Java arbeiten mehrere Klassenlader in einer Kette zusammen: 


> An erster Stelle steht der Klassenlader für alle »Kern«-Klassen, der Bootstrap-Klassenlader. 
Er lädt zentrale Typen wie Object und String aus der Laufzeitbibliothek. Findet er eine 
gewünschte Klasse nicht, geht die Anfrage weiter. 
Der Plattform-Klassenlader (vor Java 8 »extension class loader« genannt) lädt weitere Klas- 
sen aus der Distribution, die keine Kernklassen sind. 
Applikations-Klassenlader (auch System-Klassenlader): Wenn eine Klasse auch vom Platt- 
form-Klassenlader nicht gefunden wurde, folgt die Suche über den benutzerdefinierten 
Klassen- bzw. Modulpfad. 


Aus Sicherheitsgründen beginnt der Klassenlader bei einer neuen Klasse immer mit dem 
Bootstrap-Klassenlader und reicht dann die Anfrage weiter, wenn er selbst die Klasse nicht 
laden konnte. Dazu sind die Klassenlader miteinander verbunden. Jeder Klassenlader L hat 
dazu einen Vater-Klassenlader V. Erst darf der Vater versuchen, die Klassen zu laden. Kann er 
es nicht, gibt er die Arbeit an L ab. 


Hinter dem letzten Klassenlader können wir einen eigenen benutzerdefinierten Klassenla- 
der installieren. Auch dieser wird einen Vater haben, den üblicherweise der Applikations- 
Klassenlader verkörpert. 


Abfragen des Klassenpfades 


Ob der eigene Klassenpfad überhaupt gesetzt ist, ermittelt ein einfaches echo %CLASSPATH% 
(Windows) bzw. echo $CLASSPATH (Unix). 


Zur Laufzeit steht der normale Klassenpfad in der System-Property java.class.path. 
Eigenschaft Beispielbelegung 


java.class.path C:\Users\Christian\Insel\programme\2_17_Reflection_Annotationen 


Tabelle 16.4 Mögliche Ausgabe von System.out.printIn(System.getProperty("java.class.path")) 


Hinweis 
Wird die JVM über java -jar aufgerufen, beachtet sie nur Klassen in dem genannten JAR und 
ignoriert den Klassenpfad. 
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16.4.1 Die Klasse java.lang.ClassLoader 


Jeder Klassenlader in Java ist vom Typ java.lang.ClassLoader. Die Methode loadClass (...) 
erwartet einen sogenannten binären Namen, der an den voll qualifizierten Klassennamen 
erinnert. 


abstract class java.lang.ClassLoader 


m protected Class<?> loadClass (String name, boolean resolve) 
Lädt die Klasse und bindet sie mit resolveClass(..) ein, wenn resolve gleich true ist. 


m Class<?> loadClass (String name) 
Die öffentliche Methode ruft loadClass(name, false) auf, was bedeutet, dass die Klasse 
nicht standardmäßig angemeldet (gelinkt) wird. Beide Methoden können eine ClassNot- 
FoundException auslösen. 


Die geschützte Methode führt anschließend drei Schritte durch: 


1. Wird loadClass(..) auf einer Klasse aufgerufen, die dieser Klassenlader schon eingelesen 
hat, so kehrt die Methode mit dieser gecachten Klasse zurück. 


. Ist die Klasse nicht gespeichert, darf zuerst der Vater (Parent Class Loader) versuchen, die 
Klasse zu laden. 


. Findet der Vater die Klasse nicht, so darfjetzt der Klassenlader selbst mit findClass(...) ver- 
suchen, die Klasse zu beziehen. 


Eigene Klassenlader überschreiben in der Regel die Methode findClass(..), um nach einem 
bestimmten Schema zu suchen, etwa nach Klassen aus der Datenbank. In diesen Stufen ist es 
auch möglich, höher stehende Klassenlader zu umgehen, was beispielsweise bei Servlets 
Anwendung findet. 


16.5 Die Utility-Klassen System und Properties 


In der Klasse java. lang . System finden sich Methoden zum Erfragen und Ändern von System- 
variablen, zum Umlenken der Standarddatenströme, zum Ermitteln der aktuellen Zeit, zum 
Beenden der Applikation und noch für das ein oder andere. Alle Methoden sind ausschließ- 
lich statisch, und ein Exemplar von System lässt sich nicht anlegen. In der Klasse java.lang. 
Runtime finden sich zusätzlich Hilfsmethoden, wie etwa für das Starten von externen Pro- 
grammen oder Methoden zum Erfragen des Speicherbedarfs. Anders als System ist hier nur 
eine Methode statisch, nämlich die Singleton-Methode getRuntime(), die das Exemplar von 
Runtime liefert. 


16.5 Die Utility-Klassen System und Properties 


java: :lang: :System java: :lang: :Runtime 


+ err : PrintStream + addShutdownHook(hook : Thread) 
+ in : InputStream + availableProcessors() : int 
+ out : PrintStream + exec(cmdarray : String[], envp : String[], dir : Fil 
+ exec(command : String, envp : String[], dir File) 
+ exec(command : String) : Process 
+ exec(cmdarray : String[]) : Process 

( 

( 


+ arraycopy(src : Object, srcPos : int, dest : Object, destPos : int, length : int) 
+ clearProperty(key : String) : String 


+ exec(cmdarray : String[], envp : String[]) : Process 


+ console() : Console + exec(command : String, envp : String[]) : Process 
+ currentTimeMillis() : long + exit(status : int) 


+ exit(status : int 
+ freeMemory() : long 
+. gc . . + .gc() 
Ł A sii puo ; stri : stri + getLocalizedInputStream(in : InputStream) : InputStr 
+ getProperty(key : String, def : String) : String + getLocalizedOutputStream(out: OutputStream) : Output 


+ getProperty(key : String) : String + getRuntime() : Runtime 


+ getSecuritylanager() £ SecurityManager + halt(status : int) 

+ getenv(name: String) : String + load(filename : String) 

+ getenv() : Map . . + loadLibrary(libname : String) 

+ identityHashCode(x : Object) : int + maxMemory() : long 

+ inheritedChannel() : Channel + removeShutdownHook(hook : Thread) : boolean 


+ load(filename : Strin: + runFinalization() 


+ loadLibrary(libname : String) Re A 
+ mapLibraryName(libname : String) : String 5 SITE : boolean) 


+ ranoTine{ + dong + tracelnstructions(on : boolean) 
+ runFinalization() + traceMethodCalls(on : boolean) 


+ runfinalizersOnExit(Value : boolean) 


+ setErr(err : PrintStream 


e) : Process 
: Process 


eam 
Stream 


+ setIn(in : InputStream) 
+ setOut(out : PrintStream) 


+ setProperties(props : Properties) 
+ setProperty(key : String, value : String) : String 
+ setSecurityManager(s : SecurityManager) 


Abbildung 16.4 Eigenschaften der Klassen »System« und »Runtime« 


Bemerkung 


Insgesamt machen die Klassen System und Runtime keinen besonders aufgeräumten Eindruck 
(siehe Abbildung 16.4); sie wirken irgendwie so, als sei hier alles zu finden, was an anderer 
Stelle nicht mehr hineingepasst hat. Auch wären manche Methoden der einen Klasse 
genauso gut in der anderen Klasse aufgehoben. 


Dass die statische Methode System.arraycopy(..) zum Kopieren von Arrays nicht in 
java.util.Arrays stationiert ist, lässt sich nur historisch erklären. Und System. exit(int) lei- 
tet an Runtime.getRuntime().exit(int) weiter. Einige Methoden sind veraltet und anders 
verteilt: Das exec (..) von Runtime zum Starten von externen Prozessen übernimmt eine neue 
Klasse ProcessBuilder, und die Frage nach dem Speicherzustand oder der Anzahl der Prozes- 
soren beantworten MBeans, wie etwa ManagementFactory.getOperatingSystemMX- 
Bean().getAvailableProcessors(). Aber API-Design ist wie Sex: Eine unüberlegte Aktion, 
und die Brut lebt mit uns für immer. 


16.5.1 Speicher der JVM 
Das Runtime -Objekt hat drei Methoden, die Auskunft über den Speicher der JVM geben: 


> maxMemory() liefert die Anzahl der Bytes, die maximal für die JVM verfügbar sind. Der Wert 
kann beim Aufruf der JVM mit -Xmx in der Kommandozeile gesetzt werden. 
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totalMemory() ist das, was aktuell genutzt wird und bis auf maxMemory() wachsen kann. Es 16.5.3 Systemeigenschaften der Java-Umgebung 


kann prinzipiell auch wieder schrumpfen. Es gilt: maxMemory() > totalMemory(). Die Java-Umgebung verwaltet Systemeigenschaften wie Pfadtrenner oder die Version der 
freeMemory() ist das, was frei für neue Objekte ist und die automatische Speicherbereini- virtuellen Maschine in einem java.util.Properties-Objekt. Die statische Methode System. 
gung auch wieder anhebt. Es gilt: totalMemory() > freeMemory(). Allerdings ist freeMemory() getProperties() erfragt diese Systemeigenschaften und liefert das gefüllte Properties- 
nicht der gesamte freie verfügbare Speicherbereich, denn es fehlt noch der »Anteil« von Objekt zurück. Zum Erfragen einzelner Eigenschaften ist das Properties-Objekt aber nicht 
maxMemory(). unbedingt nötig: System.getProperty(..) erfragt direkt eine Eigenschaft. 


Zwei Informationen fehlen also, die berechnet werden müssen: 

Benutzter Speicher: Beispiel 
ib N des Betrieb t : 

long usedMemory = Runtime.getRuntime().totalMemory() - Runtime.getRuntime().freeMemory(); ib den Name nd Bee Yetene aNs 

System.out.println( System.getProperty( "os.name" ) ); // z. B. Windows 10 


Freier Gesamtspeicher: Gib alle Systemeigenschaften auf dem Bildschirm aus: 
long totalFreeMemory = Runtime.getRuntime().maxMemory() - usedMemory; System.getProperties().list( System.out ); 
Die Ausgabe beginnt mit: 
Beispiel -- listing properties -- 


Gib Informationen über den Speicher auf einem Rechner aus: sun.desktop=windows 
awt.toolkit=sun.awt.windows.WToolkit 


java.specification.version=9 
file.encoding.pkg=sun.io 
sun.cpu.isalist=amd64 


long totalMemory = Runtime.getRuntime().totalMemory(); 
long freeMemory = Runtime.getRuntime().freeMemory(); 
long maxMemory = Runtime.getRuntime() .maxMemory(); 
long usedMemory totalMemory - freeMemory; 

long totalfreeMemory = maxMemory - usedMemory; 
System.out.printf( Tabelle 16.5 zeigt eine Liste der wichtigen Standardsystemeigenschaften: 
"total=%d MiB, free=%d MiB, max=%d MiB, used=%d MiB, total free=%d MiB%n", 
totalMemory >> 20, freeMemory >> 20, maxMemory >> 20, 

usedMemory >> 20, totalFreeMemory >> 20 ); java.version Version der Java-Laufzeitumgebung 


Die Ausgabe kann sein: 


Schlüssel Bedeutung 


java.class.path eigener Klassenpfad 
total=126 MiB, free=124 MiB, max=2016 MiB, used=1 MiB, total free=2014 MiB 
java.library.path Pfad für native Bibliotheken 


java.io.tmpdir Pfad für temporäre Dateien 


16.5.2 Anzahl der CPUs bzw. Kerne N 
0S.name Name des Betriebssystems 


Die Runtime-Methode availableProcessors() liefert die Anzahl logischer Prozessoren bzw. 


Kerne file.separator Trenner der Pfadsegmente, etwa / (Unix) oder \ (Windows) 


path.separator Trenner bei Pfadangaben, etwa : (Unix) oder ; (Windows) 


Beispiel line.separator Zeilenumbruchzeichen(folge) 


System.out.printlin( Runtime.getRuntime().availableProcessors() ); // 4 
user.name Name des angemeldeten Benutzers 


Tabelle 16.5 Standardsystemeigenschaften 
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Schlüssel Bedeutung 
user.home Home-Verzeichnis des Benutzers 


user.dir aktuelles Verzeichnis des Benutzers 


Tabelle 16.5 Standardsystemeigenschaften (Forts.) 


API-Dokumentation 


Ein paar weitere Schlüssel zählt die API-Dokumentation bei System.getProperties() auf. 
Einige der Variablen sind auch anders zugänglich, etwa über die Klasse File. 


final class java.lang.System 


= static String getProperty(String key) 
Gibt die Belegung einer Systemeigenschaft zurück. Ist der Schlüssel null oder leer, gibt es 
eine NullPointerException bzw. eine IllegalArgumentException. 


static String getProperty(String key, String def) 

Gibt die Belegung einer Systemeigenschaft zurück. Ist sie nicht vorhanden, liefert die 
Methode die Zeichenkette def, den Default-Wert. Für die Ausnahmen gilt das Gleiche wie 
bei getProperty(String). 

static String setProperty(String key, String value) 

Belegt eine Systemeigenschaft neu. Die Rückgabe ist die alte Belegung - oder null, falls es 
keine alte Belegung gab. 

static String clearProperty(String key) 

Löscht eine Systemeigenschaft aus der Liste. Die Rückgabe ist die alte Belegung - oder 
null, falls es keine alte Belegung gab. 

static Properties getProperties() 

Liefert ein mit den aktuellen Systembelegungen gefülltes Properties-Objekt. 


16.5.4 Eigene Properties von der Konsole aus setzen * 

Eigenschaften lassen sich auch beim Programmstart von der Konsole aus setzen. Dies ist 
praktisch für eine Konfiguration, die beispielsweise das Verhalten des Programms steuert. In 
der Kommandozeile werden mit -D der Name der Eigenschaft und nach einem Gleichheits- 
zeichen (ohne Weißraum) ihr Wert angegeben. Das sieht dann etwa so aus: 


$ java -DLOG -DUSER=Chris -DSIZE=100 com.tutego.insel.lang.SetProperty 


Die Property LOG ist einfach nur »da«, aber ohne zugewiesenen Wert. Die nächsten beiden 
Properties, USER und SIZE, sind mit Werten verbunden, die erst einmal vom Typ String sind 
und vom Programm weiterverarbeitet werden müssen. Die Informationen tauchen nicht bei 
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der Argumentliste in der statischen main(String[ ])-Methode auf, da sie vor dem Namen der 
Klasse stehen und bereits von der Java-Laufzeitumgebung verarbeitet werden. 


KY Run Configurations 


Create, manage, and run configurations 


Run a Java application 


C P f B x | =| Name: | SetProperty 


type filter text @ Main \09= Arguments > Bi JRE So Dependencies | E/ Source | M Environment | ?2 
O SetProperty 
0 SHATest 
7 ShowFields 
O SocketProperties 
O StoreFinder 
O StrLenDemo Variables... 
O SuppressedClosed 
O SuppressedClosed VM arguments: 
mT 
m TG 
7 ThreadinThreadGr 
7 UrlEquals 
7 Wikipedialmagelc Variables... 
7 WritelnFile 
TI WriteTinyPPM Working directory: 
O XMLStreamReader ® Default: S{workspace_loc:Inselprogramme} 
O XsITransformer O Other: 
© ZipListDemo 
Ju JUnit Workspace... File System... Variables... 
‚Ju JUnit Plug-in Test 
æ Launch Group > 
> 


Program arguments: 


E x Show Command Line 
Filter matched 101 of 120 items 


AN 
D 


Abbildung 16.5 Entwicklungsumgebungen erlauben es, die Kommandozeilenargumente in 
einem Fenster zu setzen. Unter Eclipse gehen wir dazu unter »Run » Run Configurations« zum 
Reiter »Arguments«. 


Um die Eigenschaften auszulesen, nutzen wir das bekannte System.getProperty(...): 


Listing 16.3 com/tutego/insel/lang/SetProperty.java, main() 
Optional<String> logProperty = ofNullable( System.getProperty( "LOG" ) ); 


Optional<String> usernameProperty = ofNullable( System.getProperty( "USER" ) ); 
Optional<String> sizeProperty = ofNullable( System.getProperty( "SIZE" ) ); 


System.out.println( logProperty.isPresent() ); // true 
usernameProperty.ifPresent( System.out::println ); // Chris 
sizeProperty.map( Integer::parseInt ).ifPresent( System.out::printlin ); // 100 

System.out.printlin( System.getProperty( "DEBUG", "false" ) ); // false 


Wir bekommen über getProperty(String) einen String zurück, der den Wert anzeigt. Falls es 
überhaupt keine Eigenschaft dieses Namens gibt, erhalten wir stattdessen null. So wissen wir 
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auch, ob dieser Wert überhaupt gesetzt wurde. Ein einfacher null-Test sagt also aus, ob log- 
Property vorhanden ist oder nicht. Statt -DLOG führt auch -DLOG= zum gleichen Ergebnis, denn 
der assoziierte Wert ist der Leer-String. Da alle Properties erst einmal vom Typ String sind, 
lässt sich usernameProperty einfach ausgeben, und wir bekommen entweder null oder den 
hinter = angegebenen String. Sind die Typen keine Strings, müssen sie weiterverarbeitet wer- 
den, also etwa mit Integer. parseInt(), Double.parseDouble() usw. Nützlich ist die Methode 
System.getProperty(String, String), der zwei Argumente übergeben werden, denn das 
zweite Argument steht für einen Default-Wert. So kann immer ein Standardwert angenom- 
men werden. 


Boolean.getBoolean(String) 


Im Fall von Properties, die mit Wahrheitswerten belegt werden, kann Folgendes geschrieben 
werden: 


boolean b = Boolean.parseBoolean( System.getProperty( property ) ); // (*) 


Für die Wahrheitswerte gibt es eine andere Variante. Die statische Methode Boolean. getBoo- 
lean(String) sucht aus den System-Properties eine Eigenschaft mit dem angegebenen 
Namen heraus. Analog zur Zeile (*) ist also: 


boolean b = Boolean.getBoolean( property ); 


Es ist schon erstaunlich, diese statische Methode in der Wrapper-Klasse Boolean anzutreffen, 
weil Property-Zugriffe nichts mit den Wrapper-Objekten zu tun haben und die Klasse hier 
eigentlich über ihre Zuständigkeit hinausgeht. 


Gegenüber einer eigenen, direkten System-Anfrage hat getBoolean(String) auch den Nach- 
teil, dass wir bei der Rückgabe false nicht unterscheiden können, ob es die Eigenschaft 
schlichtweg nicht gibt oder ob die Eigenschaft mit dem Wert false belegt ist. Auch falsch 
gesetzte Werte wie -DP=false ergeben immer false.? 


final class java.lang.Boolean 
implements Serializable, Comparable<Boolean> 


m static boolean getBoolean(String name) 
Liest eine Systemeigenschaft mit dem Namen name aus und liefert true, wenn der Wert der 
Property gleich dem String "true" ist. Die Rückgabe ist false, wenn entweder der Wert der 
Systemeigenschaft "false" ist oder wenn er nicht existiert oder null ist. 


2 Das liegt an der Implementierung: Boolean. valueOf("false") liefert genauso false wie Boo- 
lean.valueof("") oder Boolean. valueOf (null). 
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16.5.5 Zeilenumbruchzeichen, line.separator 


Um nach dem Ende einer Zeile an den Anfang der nächsten zu gelangen, wird ein Zeilenum- 
bruch (engl. new line) eingefügt. Das Zeichen für den Zeilenumbruch muss kein einzelnes 
sein, es können auch mehrere Zeichen nötig sein. Zum Leidwesen der Programmierer unter- 
scheidet sich die Anzahl der Zeichen für den Zeilenumbruch auf den bekannten Architek- 
turen: 


> Unix: Line Feed (Zeilenvorschub) 
> Macintosh: Carriage Return (Wagenrücklauf) 


> Windows: beide Zeichen (Carriage Return und Line Feed) 


Der Steuercode für Carriage Return (kurz CR) ist 13 (OxOD), der für Line Feed (kurz LF) 10 
(OxOA). Java vergibt obendrein eigene Escape-Sequenzen für diese Zeichen: \r für Carriage 
Return und \n für Line Feed. (Die Sequenz \f für einen Form Feed, also einen Seitenvorschub, 
spielt bei den Zeilenumbrüchen keine Rolle.) 


In Java gibt es drei Möglichkeiten, an das Zeilenumbruchzeichen bzw. die Zeilenumbruchzei- 
chenfolge des Systems heranzukommen: 


1. mit dem Aufruf von System.getProperty("line.separator") 

2. mit dem Aufruf von System.lineSeparator() 

3. Nicht immer ist es nötig, das Zeichen (bzw. genau genommen eine mögliche Zeichenfolge) 
einzeln zu erfragen. Ist das Zeichen Teil einer formatierten Ausgabe beim Formatter, 


String.format (..) bzw. printf(..), so steht der Formatspezifizierer %n für genau die im Sys- 
tem hinterlegte Zeilenumbruchzeichenfolge. 


16.5.6 Umgebungsvariablen des Betriebssystems 


Fast jedes Betriebssystem nutzt das Konzept der Umgebungsvariablen (engl. environment 
variables); bekannt ist etwa PATH für den Suchpfad für Applikationen unter Windows und 
unter Unix. Java macht es möglich, auf diese System-Umgebungsvariablen zuzugreifen. 
Dazu dienen zwei statische Methoden: 


final class java.lang.System 


= static Map<String, String> getEnv() 
Liest eine Menge von «String, String>-Paaren mit allen Systemeigenschaften. 
= static String getEnv(String name) 
Liest eine Systemeigenschaft mit dem Namen name. Gibt es sie nicht, ist die Rückgabe null. 
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Beispiel 
Was ist der Suchpfad? Den liefert System.getenv("path"); 


Name der Variablen Beschreibung Beispiel 
COMPUTERNAME Name des Computers MOE 


HOMEDRIVE Laufwerk des Benutzerverzeich- @ 
nisses 


HOMEPATH Pfad des Benutzerverzeichnisses \Users\Christian 
os Name des Betriebssystems* Windows _NT 


Suchpfad C:\windows\SYSTEM32; 
C:\windows ... 


PATHEXT Dateiendungen, die für ausführbare | .COM;.EXE;.BAT;.CMD;.VBS; 
Programme stehen . VBE; JS; JSE;.WSF;.WSH;.MSC 


SYSTEMDRIVE Laufwerk des Betriebssystems @ 


TEMP und auch TMP temporäres Verzeichnis C:\Users\CHRIST*1\AppData\ 


Local\Temp 
USERDOMAIN Domäne des Benutzers MOE 
USERNAME Name des Nutzers Christian 


USERPROFILE Profilverzeichnis C:\Users\Christian 


WINDIR Verzeichnis des Betriebssystems C:\windows 


* Das Ergebnis weicht von System.getProperty("os.name") ab, was bei Windows 10 schon 
»Windows 10« liefert. 


Tabelle 16.6 Auswahl einiger unter Windows verfügbarer Umgebungsvariablen 


Einige der Variablen sind auch über die System-Properties (System.getProperties(), System. 


getProperty(..)) erreichbar. 


Beispiel 
Gib die Umgebungsvariablen des Systems aus: 


Map<String,String> map = System.getenv(); 
map.forEach( (k, v) -> System.out.printf( "%s=%s%n", kK, v) ); 


16.6 Sprachen der Länder 


16.6 Sprachen der Länder 


Beginnen Entwickler mit Ausgaben auf der Konsole oder grafischen Oberfläche, so verdrah- 
ten sie oft die Ausgabe fest mit einer Landessprache. Ändert sich die Sprache, kann die Soft- 
ware nicht mit anderen landesüblichen Regeln etwa bei der Formatierung von Fließkomma- 
zahlen umgehen. Dabei ist es gar nicht schwer, »mehrsprachige« Programme zu entwickeln, 
die unter verschiedenen Sprachen lokalisierte Ausgaben liefern. Im Grunde müssen wir alle 
sprachabhängigen Zeichenketten und Formatierungen von Daten durch Code ersetzen, der 
die landesüblichen Ausgaben und Regeln berücksichtigt. Java bietet hier eine Lösung an: 
zum einen durch die Definition einer Sprache, die dann Regeln vorgibt, nach denen die Java- 
API Daten automatisch formatieren kann, und zum anderen durch die Möglichkeit, sprach- 
abhängige Teile in Ressourcendateien auszulagern. 


16.6.1 Sprachen in Regionen über Locale-Objekte 


In Java repräsentieren Locale-Objekte Sprachen in geografischen, politischen oder kulturel- 
len Regionen. Die Sprache und die Region müssen getrennt werden, denn nicht immer gibt 
eine Region oder ein Land die Sprache eindeutig vor. Für Kanada in der Umgebung von 
Quebec ist die französische Ausgabe relevant, und die unterscheidet sich von der englischen. 
Jede dieser sprachspezifischen Eigenschaften ist in einem speziellen Objekt gekapselt. 
Locale-Objekte werden dann zum Beispiel einem Formatter, der hinter String. format (..) und 
printf(..) steht, oder einem Scanner übergeben. Diese Ausgaben nennen sich auf Englisch 
locale-sensitive. 


Locale-Objekte aufbauen 

Locale-Objekte werden immer mit dem Namen der Sprache und optional mit dem Namen 
des Landes bzw. einer Region und Variante erzeugt. Die Locale-Klasse bietet drei Möglichkei- 
ten zum Aufbau der Objekte: 

> mit dem Locale-Konstruktor 


> Die geschachtelte Klasse Builder von Locale nutzt das Builder-Pattern zum Aufbau neuer 
Locale-Objekte. 


über die Locale-Methode forLanguageTag(..) und eine String-Kennung 


Beispiel 
Im Konstruktor der Klasse Locale werden Länderabkürzungen angegeben, etwa für ein 


Sprachobjekt für Großbritannien oder Frankreich: 


Locale greatBritain = new Locale( "en", "GB" ); 
Locale french = few Loeallel "nz" J; 
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Im zweiten Beispiel ist uns das Land egal. Wir haben einfach nur die Sprache Französisch aus- 
gewählt, egal in welchem Teil der Welt. 


Die Sprachen sind durch Zwei-Buchstaben-Kürzel aus dem ISO-639-Code? (ISO Language 
Code) identifiziert, und die Ländernamen sind Zwei-Buchstaben-Kürzel, die in ISO 3166? (ISO 
Country Code) beschrieben sind. 


Beispiel 
Drei Varianten zum Aufbau der Locale. JAPANESE: 


Locale loc1 = new Locale( "ja" ); 
Locale loc2 = new Locale.Builder().setLanguage( "ja" ).build(); 
Locale loc3 = Locale.forLanguageTag( "ja" ); 


final class java.util.Locale 
implements Cloneable, Serializable 


Locale(String language) 
Erzeugt ein neues Locale-Objekt für die Sprache (language), die nach dem ISO-693-Stan- 
dard gegeben ist. Ungültige Kennungen werden nicht erkannt. 


Locale(String language, String country) 
Erzeugt ein Locale-Objekt für eine Sprache (language) nach ISO 693 und ein Land (country) 
nach dem ISO-3166-Standard. 


Locale(String language, String country, String variant) 
Erzeugt ein Locale-Objekt für eine Sprache, ein Land und eine Variante. variant ist eine 
herstellerabhängige Angabe wie »WIN« oder »MAC«. 


Die statische Methode Locale.getDefault() liefert die aktuell eingestellte Sprache. Für die 
laufende JVM kann Locale.setDefault(Locale) die Sprache ändern. 


Die Locale-Klasse hat weitere Methoden; Entwickler sollten für den Builder, für forLanguage- 
Tag(..) und die neuen Erweiterungen und Filtermethoden die Javadoc studieren.’ 


Konstanten für einige Sprachen 


Die Locale-Klasse besitzt Konstanten für häufig auftretende Sprachen optional mit Ländern. 
Unter den Konstanten für Länder und Sprachen sind: CANADA, CANADA_FRENCH, CHINA ist gleich 
CHINESE (und auch PRC bzw. SIMPLIFIED CHINESE), ENGLISH, FRANCE, FRENCH, GERMAN, GERMANY, 


3 https://de.wikipedia.org/wiki/Liste_der _1SO-639-1-Codes 

4 https://de.wikipedia.org/wiki/1SO-3166-1-Kodierliste 

5 AufEnglisch beschreibt das Java-Tutorial von Oracle die Erweiterungen unter http://docs.oracle.com/ 
Javase/tutorial/il8n/locale/index.html. 
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ITALIAN, ITALY, JAPAN, JAPANESE, KOREA, KOREAN, TAIWAN (ist gleich TRADITIONAL CHINESE), UK und 
US. Hinter einer Abkürzung wie Locale.UK steht nichts anderes als die Initialisierung mit new 
Locale("en", "GB"). 


Methoden, die Locale-Exemplare annehmen 


Locale-Objekte sind als Objekte eigentlich uninteressant - sie haben Methoden, doch span- 
nender ist der Typ als Identifikation für eine Sprache. In der Java-Bibliothek gibt es Dutzende 
von Methoden, die Locale-Objekte annehmen und anhand deren ihr Verhalten anpassen. 
Beispiele sind printf(Locale, ..), format(Locale, ..) und toLowerCase(Locale). 


Tipp 

Gibt es keine Variante einer Formatierungs- bzw. Parse-Methode mit einem Locale-Objekt, so 
unterstützt die Methode in der Regel kein sprachabhängiges Verhalten. Das Gleiche gilt für 
Objekte, die kein Locale über einen Konstruktor bzw. Setter annehmen. Double. toString(...) 
ist so ein Beispiel, auch Double. parseDouble (...). In internationalisierten Anwendungen wer- 
den diese Methoden selten zu finden sein. Auch eine String-Konkatenation mit beispielsweise 
einer Fließkommazahl ist nicht erlaubt (sie ruft intern eine Double-Methode auf), und ein 
String.format(...) ist allemal besser. 


Methoden von Locale * 


Locale-Objekte bieten eine Reihe von Methoden an, die etwa den ISO-639-Code des Landes 
preisgeben. 


Beispiel 
Gib für Sprachen in ausgewählten Ländern zugängliche Locale-Informationen aus. Die 
Objekte System.out und Locale.* sind statisch importiert: 


Listing 16.4 src/main/java/com/tutego/insel/locale/Germanylocal.java, main() 


ut.println(GER 
(G 
(G 
(G 
ut.println(G 


n Y.getCountry()); // DE 
n 
n 
n 
n 
une ooa ime Lae 
n 
n 
n 
n 
n 


Y.getLanguage()); // de 


Al 
ut.printl A 
ANY.getVariant()); IM 
Al 
Al 


ut.printl 
ut.printl Y.get1S03Country()); // DEU 
Y.getISO3Language()); // deu 
ADA.getDisplayCountry()); // Kanada 
Y.getDisplayLanguage()); // Deutsch 
ANY.getDisplayName()); // Deutsch (Deutschland) 
(CANADA. getDisplayName() ); // Englisch (Kanada) 
(GERMANY.getDisplayName(FRENCH)); // allemand (Allemagne) 
(CANADA.getDisplayName(FRENCH)); // anglais (Canada) 


(G 
(G 


ut.printl 
ut.printl 


ut.printl 


nn 2> mel Imeı 9 nei Imel Inn mm m 


ut.printl 


SEO SOZESTESHE SEE STE SHE SE STE 


ut.printl 
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Es gibt auch statische Methoden zum Erfragen von Locale-Objekten: 


final class java.util.Locale 
implements Cloneable, Serializable 


static Locale getDefault() 

Liefert die von der JVM voreingestellte Sprache, die standardmäßig vom Betriebssystem 
stammt. 

static Locale[ ] getAvailablelocales() 

Liefert eine Aufzählung aller installierten Locale-Objekte. Das Feld enthält mindestens 
Locale.US und ca. 160 Einträge. 

static String|[ ] getISOCountries() 

Liefert ein Array mit allen aus zwei Buchstaben bestehenden ISO-3166-Country-Codes. 


static Set<String> getISOCountries (Locale.IsoCountryCode type) 

Liefert eine Menge mit allen ISO-3166-Country-Codes, wobei die Aufzählung IsoCountry- 
Code bestimmt: PART1_ALPHA2 liefert den Code aus zwei Buchstaben, PART1_ALPHA3 aus drei 
Buchstaben, PART3 aus vier Buchstaben. 


Auf der anderen Seite haben wir Methoden, die die Kürzel nach den ISO-Normen liefern: 


final class java.util.Locale 
implements Cloneable, Serializable 


String getCountry() 

Liefert das Länderkürzel nach dem ISO-3166-zwei-Buchstaben-Code. 

String getLanguage() 

Liefert das Kürzel der Sprache im ISO-639-Code. 

String get1S03Country() 

Liefert die ISO-Abkürzung des Landes dieser Einstellungen und löst eine MissingResource- 
Exception aus, wenn die ISO-Abkürzung nicht verfügbar ist. 

String get1S03Language() 

Liefert die ISO-Abkürzung der Sprache dieser Einstellungen und löst eine Missing- 
ResourceException aus, wenn die ISO-Abkürzung nicht verfügbar ist. 

String getVariant() 

Liefert das Kürzel der Variante oder einen leeren String. 


Die genannten Methoden liefern zwar Kürzel, aber sie sind nicht gedacht als für Menschen 
lesbare Ausgabe. Für diverse get*()-Methoden gibt es entsprechende getDisplay*()- 
Methoden: 


16.7 Wichtige Datum-Klassen im Überblick 


final class java.util.Locale 
implements Cloneable, Serializable 


String getDisplayCountry(Locale inLocale) 

final String getDisplayCountry() 

Liefert den Namen des Landes für Bildschirmausgaben für eine Sprache oder Loacale.get- 
Default(). 

String getDisplayLanguage(Locale inLocale) 

String getDisplayLanguage() 

Liefert den Namen der Sprache für Bildschirmausgaben für eine gegebene Locale oder 
Locale.getDefault(). 

String getDisplayName(Locale inLocale) 

final String getDisplayName() 

Liefert den Namen der Einstellungen für eine Sprache oder Locale.getDefault(). 

String getDisplayVariant(Locale inLocale) 

final String getDisplayVariant() 

Liefert den Namen der Variante für eine Sprache oder Locale.getDefault(). 


16.7 Wichtige Datum-Klassen im Überblick 


Weil Datumsberechnungen verschlungene Gebilde sind, können wir den Entwicklern von 
Java dankbar sein, dass sie uns viele Klassen zur Datumsberechnung und -formatierung zur 
Verfügung stellen. Die Entwickler haben die Klassen so abstrakt gehalten, dass lokale Beson- 
derheiten wie Ausgabeformatierung, Parsen, Zeitzonen oder Sommer- und Winterzeit in ver- 
schiedenen Kalendern möglich sind. 


Bis zur Java-Version 1.1 stand zur Darstellung und Manipulation von Datumswerten aus- 
schließlich die Klasse java.util.Date zur Verfügung. Diese hatte mehrere Aufgaben: 

> Erzeugung eines Datum/Zeit-Objekts aus Jahr, Monat, Tag, Minute und Sekunde 

> Abfrage von Tag, Monat, Jahr ... mit der Genauigkeit von Millisekunden 

> Ausgabe und Verarbeitung von Datum-Zeichenketten 


Da die Date-Klasse nicht ganz fehlerfrei und internationalisiert war, wurden im JDK 1.1 neue 
Klassen eingeführt: 


> Calendar nimmt sich der Aufgabe von Date an, zwischen verschiedenen Datumsrepräsen- 
tationen und Zeitskalen zu konvertieren. Die Unterklasse GregorianCalendar wird direkt 
erzeugt. 
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> DateFormat zerlegt Datum-Zeichenketten und formatiert die Ausgabe. Auch Datumsfor- 
mate sind vom Land abhängig, das Java durch Locale-Objekte darstellt, und von einer Zeit- 
zone, die durch die Exemplare der Klasse TimeZone repräsentiert ist. 


In Java 8 zog eine weitere Datumsbibliothek mit ganz neuen Typen ein. Endlich können auch 
Datum und Zeit getrennt repräsentiert werden: 


>» LocalDate, LocalTime, LocalDateTime sind die temporalen Klassen für ein Datum, für eine 
Zeit und für eine Kombination aus Datum und Zeit. 


> Period und Duration stehen für Abstände. 


16.7.1 Der 1.1.1970 


Der 1.1.1970 war ein Donnerstag mit wegweisenden Änderungen: Die Briten freuten sich, dass 
die Volljährigkeit von 24 Jahren auf 18 Jahre fiel, und wie in jedem Jahr wurde das Beschnei- 
dungsfest gefeiert. Für uns ist aber eine technische Neuerung von Belang: Der 1.1.1970, 
0:00:00 UTC heißt auch Unix-Epoche, und eine Unixzeit wird relativ zu diesem Zeitpunkt in 
Sekunden beschrieben. So kommen wir 100.000.000 Sekunden nach dem 1.1.1970 beim 
3. März 1973 um 09:46:40 aus. Das Unix Billennium wurde bei 1.000.000.000 Sekunden nach 
dem 1.1.1970 gefeiert und repräsentiert den 9. September 2001, 01:46:40. 


16.7.2 System.currentTimeMillis() 


Auch für uns Java-Entwickler ist die Unixzeit von Bedeutung, denn viele Zeiten in Java sind 
relativ zu diesem Datum. Der Zeitstempel O bezieht sich auf den 1.1.1970 0:00:00 Uhr Green- 
wich-Zeit - das entspricht 1 Uhr nachts deutscher Zeit. Die Methode System.currentTimeMil- 
lis() liefert die vergangenen Millisekunden - nicht Sekunden! - relativ zum 1.1.1970, 00:00 
Uhr UTC, wobei allerdings die Uhr des Betriebssystems nicht so genau gehen muss. Die 
Anzahl der Millisekunden wird in einem long repräsentiert, also in 64 Bit. Das reicht für etwa 
300 Millionen Jahre. 


Warnung 

Die Werte von currentTimeMillis() sind nicht zwingend aufsteigend, da sich Java die Zeit 
vom Betriebssystem holt, und da kann sich die Systemzeit ändern. Der Benutzer kann die Zeit 
anpassen, oder ein Dienst wie das Network Time Protocol (NTP) übernimmt diese Aufgabe. 
Differenzen von currentTimeMillis()-Zeitstempeln sind dann komplett falsch und könnten 
sogar negativ sein. Eine Alternative ist nanoTime(), das keinen Bezugspunkt hat, genauer und 
immer aufsteigend ist.® 


6 Die Seite http://stackoverflow.com/questions/351565/system-currenttimemillis-vs-system-nanotime geht 
auf Details ein und verlinkt aufinterne Implementierungen. 
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16.7.3 Einfache Zeitumrechnungen durch TimeUnit 


Eine Zeitdauer wird in Java oft durch Millisekunden ausgedrückt. 1.000 Millisekunden ent- 
sprechen 1 Sekunde, 1.000 x 60 Millisekunden 1 Minute usw. Diese ganzen großen Zahlen 
sind jedoch nicht besonders anschaulich, sodass zur Umrechnung TimeUnit-Objekte mit 
ihren to*(..)-Methoden genutzt werden. Java deklariert folgende Konstanten in Timelnit: 
NANOSECONDS, MICROSECONDS, MILLISECONDS, DAYS, HOURS, SECONDS, MINUTES. 


Jedes der Aufzählungselemente definiert die Umrechnungsmethoden toDays (...), toHours (...), 
toMicros(..), toMillis(..), toMinutes(..), toNanos(..), toSeconds(..); sie bekommen ein long 
und liefern ein long in der entsprechenden Einheit. Zudem gibt es zwei convert (..)-Metho- 
den, die von einer Einheit in eine andere umrechnen. 


Beispiel 

Konvertiere 23.746.387 Millisekunden in Stunden: 

int v = 23_746 387; 

System.out.printlin( TimeUnit.MILLISECONDS.toHours( v ) ); // 6 
System.out.println( TimeUnit.HOURS.convert( v, TimeUnit.MILLISECONDS ) ); // 6 


enum java.util.concurrent.TimeUnit 
extends Enum<TimeUnit> 
implements Serializable, Comparable<TimeUnit> 


NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS 
Aufzählungselemente von TimeUnit 


toDays (long duration) 
Hours (long duration) 
icros(long duration) 
illis(long duration) 


inutes (long duration) 


anos(long duration) 


toSeconds (long duration) 


long convert (long sourceDuration, TimeUnit sourceUnit) 

Liefert sourcelnit.to*(sourceDuration), wobei * für die jeweilige Einheit steht. Beispiels- 
weise liefert es HOURS.convert (sourceDuration, sourceUnit), dann sourcelUnit.toHours(1). 
Die Lesbarkeit der Methode ist nicht optimal, daher sollten die anderen Methoden bevor- 
zugt werden. Ergebnisse werden unter Umständen abgeschnitten, nicht gerundet. Gibt es 
einen Überlauf, folgt keine Arithmetic£xception. 
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long convert (Duration duration) 

Konvertiert die übergebene duration in die Zeiteinheit, die die aktuelle TimeUnit repräsen- 
tiert. So liefert TimeUnit.MINUTES.convert( Duration.ofHours (12) ) zum Beispiel 720. Damit 
sind etwa aunit.convert(Duration.ofNanos(n)) und aunit.convert(n, NANOSECONDS) gleich. 
Neu seit Java 11. 


16.8 Date-Time-APl 


Seit Java 8 gibt es das Paket java.time, das alle bisherigen Java-Typen rund um Datum- und 
Zeitverarbeitung überflüssig macht. Mit anderen Worten: Mit den neueren Typen lassen sich 
Date, Calendar, GregorianCalendar, TimeZone usw. streichen und ersetzen. Natürlich gibt es 
Adapter zwischen den APls, doch gibt es nur noch sehr wenige zwingende Gründe, heute bei 
neuen Programmen auf die älteren Typen zurückzugreifen - ein Grund ist natürlich die hei- 
lige Kompatibilität. 

Die neue API basiert auf dem standardisierten Kalendersystem von ISO-8601, und das deckt 
ab, wie ein Datum, wie Zeit, Datum und Zeit, UTC, Zeitintervalle (Dauer/Zeitspanne) und Zeit- 
zonen repräsentiert werden. Die Implementierung basiert auf dem gregorianischen Kalen- 
der, wobei auch andere Kalendertypen denkbar sind. Javas Kalendersystem greift aufandere 
Standards bzw. Implementierungen zurück, unter anderem auf das Unicode Common Locale 
Data Repository (CLDR) zur Lokalisierung von Wochentagen oder auf die Time-Zone Data- 
base (TZDB), die alle Zeitzonenwechsel seit 1970 dokumentiert. In Java nutzen die XML-APIs 
schon länger ISO-8601-Kalender, denn Schema-Dateien nutzen einen XMLGregorianCalendar, 
und selbst für Dauern gibt es einen eigenen Typ, Duration. 


Geschichte 


Über die alten Datumsklassen meckert die Java-Community seit über zehn Jahren — nicht 
ganz zu Unrecht. So hat ein Date zum Beispiel einen Datums- sowie einen Zeitanteil, Kalender 
fehlen, die Sommerzeitumstellung verschiedener Länder wird nicht korrekt behandelt, und es 
gibt weitere Schwächen.’ Daher geht die Entwicklung der Date-Time-API lange zurück und 
basiert auf Ideen von Joda-Time (https://www.joda.org/joda-time/), einer früher populären 
quelloffenen Bibliothek. Spezifiziert im JSR 310 (eingereicht am 30. Jan 2007),® wurde die API 
erstin Java 8 Teil der Java SE. 


Der Quellcode stammt von IBM. Trifft Oracle jetzt die Schuld, weil Sun die Implementierung damals über- 
nahm? Siehe zu den Kritiken auch http://tutego.de/go/dategotchas. 
8 http://jep.org/en/jsr/detail?’id=310 
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Erster Überblick 


Die zentralen temporalen Typen aus der Date-Time-API sind schnell dokumentiert: 


w ie) 


LocalDate Repräsentiert ein übliches Datum. | Jahr, Monat, Tag 


LocalTime Repräsentiert eine übliche Zeit. Stunden, Minuten, Sekunden, 
Nanosekunden 


LocalDateTime Kombination aus Datum und Zeit | Jahr, Monat, Tag, Stunden, Minu- 
ten, Sekunden, Nanosekunden 


Period Jahr, Monat, Tag 
MonthDay Monat, Tag 


OffsetTime Zeit mit Zeitzone Stunden, Minuten, Sekunden, 
Nanosekunden, Zonen-Offset 


OffsetDateTime Datum und Zeit mit Zeitzone als Jahr, Monat, Tag, Stunden, Minu- 
UTC-Offset ten, Sekunden, Nanosekunden, 
Zonen-Offset 


ZonedDateTime Datum und Zeit mit Zeitzone als Jahr, Monat, Tag, Stunden, Minu- 
ID und Offset ten, Sekunden, Nanosekunden, 
Zonen-Info 


Instant Zeitpunkt (fortlaufende Maschi- Nanosekunden 
nenzeit) 


Duration Zeitintervall zwischen zwei Sekunden/Nanosekunden 
Instants 


Tabelle 16.7 Alle temporalen Klassen aus »java.time« 


16.8.1 Menschenzeit und Maschinenzeit 


Datum und Zeit, die wir als Menschen in Einheiten wie Tagen und Minuten verstehen, nen- 
nen wir Menschenzeit (engl. human time), die fortlaufende Zeit des Computers, die eine Auf- 
lösung im Nanosekundenbereich hat, Maschinenzeit. Die Maschinenzeit startet dabei von 
einer Zeit, die wir Epoche nennen, z. B. die Unix-Epoche. 


Aus Abschnitt 7.2.5, »Sehen Kinder alles? Die Sichtbarkeit protected«, lässt sich gut ablesen, 
dass die meisten Klassen für uns Menschen gemacht sind und dass sich nur Instant/Duration 
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auf die Maschinenzeit bezieht. LocalDate, LocalTime und LocalDateTime repräsentieren Men- 
schenzeit ohne Bezug zu einer Zeitzone, ZonedDateTime mit Bezug auf eine Zeitzone. Bei der 
Auswahl der richtigen Zeitklassen für eine Aufgabenstellung ist natürlich die erste Überle- 
gung, ob die Menschenzeit oder die Maschinenzeit repräsentiert werden soll. Dann folgen 
die Fragen, was genau für Felder nötig sind und ob eine Zeitzone relevant ist oder nicht. Soll 
zum Beispiel die Ausführungszeit gemessen werden, ist es unnötig, zu wissen, an welchem 
Datum die Messung begann und endet; hier ist Duration korrekt, nicht Period. 


Beispiel 
LocalDate now = LocalDate.now(); 
System.out.println( now ); // 2018-03-09 
System.out.printf( "%d. %s %d%n" , 
now.getDayOfMonth(),, 
now.getMonth(), 
now.getYear() ); // 9. MARCH 2018 
LocalDate bdayMLKing = LocalDate.of( 1929, Month.JANUARY, 15 ); 
DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDate( FormatStyle.MEDIUM ); 
System.out.printIn( bdayMLKing.format( formatter ) ); // 15. Januar 1929 
Die Methode getMonth() auf einem LocalDate liefert als Ergebnis ein java.time.Month- 
Objekt, und das sind Aufzählungen. Die toString()-Repräsentation liefert die Konstante in 
Großbuchstaben. 


Alle Klassen basieren standardmäßig auf dem ISO-System. Andere Kalendersysteme, wie der 
japanische Kalender, werden über Typen aus java.time.chrono erzeugt, und natürlich sind 
auch ganz neue Systeme möglich. 


Beispiel 
ChronoLocalDate now = JapaneseChronology.INSTANCE.dateNow(); 
System.out.println( now ); // Japanese Heisei 19-10-23 


Paketübersicht 
Die Typen der Date-Time-API verteilen sich auf verschiedene Pakete: 


> java.time: Enthält die Standardklassen wie LocalTime und Instant. Alle Typen basieren auf 
dem Kalendersystem ISO-8601, das landläufig unter »gregorianischer Kalender« bekannt 
ist. Dieser wird zum sogenannten Proleptic Gregorian Calendar erweitert. Das ist ein gre- 
gorianischer Kalender, der auch für die Zeit vor 1582 (der Einführung dieses Kalenders) gül- 
tig ist, damit eine konsistente Zeitlinie entsteht. 
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java.time.chrono: Hier befinden sich vorgefertigte alternative (also Nicht-ISO-)Kalender- 
systeme, wie der japanische Kalender, der Thai-Buddhist-Kalender, der islamische Kalen- 
der und ein paar weitere. 


java.time.format: Klassen zum Formatieren und Parsen von Datum- und Zeit, wie der 
genannte DateTimeFormatter 


java.time.zone: unterstützende Klassen für Zeitzonen, etwa ZonedDateTime 


java.time.temporal: tiefer liegende API, die Zugriff und Modifikation einzelner Felder 
eines Datums/Zeitwerts erlaubt 


Designprinzipen 

Bevor wir uns mit den einzelnen Klassen auseinandersetzen, wollen wir uns mit den Design- 
prinzipien beschäftigen, denn alle Typen der Date-Time-API folgen wiederkehrenden Mus- 
tern. Die erste und wichtigste Eigenschaft ist, dass alle Objekte immutable sind, also nicht 
veränderbar. Das ist bei der »alten« API anders: Date und die Calendar-Klassen sind veränder- 
bar, mit teils verheerenden Folgen. Denn werden diese Objekte herumgereicht und verän- 
dert, kann es zu unkalkulierbaren Seiteneffekten kommen. Die Klassen der neuen Date- 
Time-API sind immutable, und so stehen die Datum/Zeit-Klassen wie LocalTime oder Instant 


den veränderbaren Typen wie Date oder Calendar gegenüber. Alle Methoden, die nach Ände- 


rung aussehen, erzeugen neue Objekte mit den gewünschten Änderungen. Seiteneffekte 
bleiben also aus, und alle Typen sind threadsicher. 


Unveränderbarkeit ist eine Designeigenschaft wie auch die Tatsache, dass null nicht als 
Argument erlaubt wird. In der Java-API wird oftmals null akzeptiert, weil es etwas Optionales 
ausdrückt, doch die Date-Time-APl straft dies in der Regel mit einer NullPointerExcpetion. 
Dass null nicht als Argument und nicht als Rückgabe im Einsatz ist, kommt einer weiteren 
Eigenschaft zugute: Die API gestattet »flüssige« Ausdrücke, also kaskadierte Aufrufe, da viele 
Methoden die this-Referenz zurückgeben, so wie das auch von StringBuilder bekannt ist. 


Zu diesen eher technischen Eigenschaften kommt die konsistente Namensgebung hinzu, die 
sich von der Namensgebung der bekannten JavaBeans absetzt. So gibt es keine Konstrukto- 
ren und keine Setter (das brauchen die immutablen Klassen nicht), sondern Muster, die viele 
der Typen aus der Date-Time-APl einhalten: 


Klassen-/Exemplar- | grundsätzliche Bedeutung 
methode 


Liefert ein Objekt mit aktueller Zeit/ aktuellem Datum. 
Erzeugt neue Objekte. 
Erzeugt neue Objekte aus anderen Repräsentationen. 


Tabelle 16.8 Namensmuster in der Date-Time-API 
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Methode Klassen-/Exemplar- | grundsätzliche Bedeutung 
methode 


parse*() statisch Erzeugt ein neues Objekt aus einer String- Repräsenta- 
tion. 


Format() Exemplar Formatiert und liefert einen String. 
get*() Exemplar Liefert Felder eines Objekts. 
is*() Exemplar Fragt den Status eines Objekts ab. 


with*() Exemplar Liefert eine Kopie des Objekts mit einer geänderten 
Eigenschaft. 


plus*() Exemplar Liefert eine Kopie des Objekts mit einer aufsummierten 
Eigenschaft. 


minus*() Exemplar Liefert eine Kopie des Objekts mit einer reduzierten 
Eigenschaft. 


to*() Exemplar Konvertiert ein Objekt in einen neuen Typ. 
at*() Exemplar Kombiniert dieses Objekt mit einem anderen Objekt. 


*Into() Exemplar Kombiniert ein eigenes Objekt mit einem anderen 
Zielobjekt. 


Tabelle 16.8 Namensmuster in der Date-Time-API (Forts.) 


Die Methode now() haben wir schon in den ersten Beispielen verwendet, sie liefert zum Bei- 
spiel das aktuelle Datum. Weitere Erzeugermethoden sind die mit dem Präfix of, from oder 
with; Konstruktoren gibt es nicht. Die Methoden nach der Bauart with*() nehmen die Rolle 
der Setter ein. 


16.8.2 Die Datumsklasse LocalDate 


Ein Datum (ohne Zeitzone) repräsentiert die Klasse LocalDate. Damit lässt sich zum Beispiel 
ein Geburtsdatum repräsentieren. 


Ein temporales Objekt kann über die statischen of (..)-Fabrikmethoden aufgebaut und über 
ofInstant (Instant instant, Zoneld zone) oder von einem anderen temporalen Objekt abge- 
leitet werden. Interessant sind die Methoden, die mit einem TemporalAdjuster arbeiten. 


Mit den Objekten in der Hand können wir diverse Getter nutzen und einzelne Felder erfra- 
gen, etwa getDayOfMonth(), getDayOfYear() (liefern int) oder getDayOfWeek(), das eine Aufzäh- 
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lung vom Typ DayOfWeek liefert, und getMonth(), das eine Aufzählung vom Typ Month liefert. 
Weiterhin gibt es long toEpochDay() und long toEpochSecond(LocalTime time, ZoneOffset off- 
set). 


Beispiel 
LocalDate today = LocalDate.now(); 
LocalDate nextSaturday = today.with( TemporalAdjusters.next(DayOfWeek.SATURDAY) ); 
System.out.printf( "Heute ist der %s, und frei ist am Samstag, den %s", 
today, nextSaturday ); 


Dazu kommen Methoden, die mit minus*(..) oder plus*(..) neue LocalDate-Objekte liefern, 
wenn zum Beispiel mit minusYear (long yearsToSubtract) eine Anzahl Jahre zurückgelaufen 
werden soll. Durch die Negation des Vorzeichens kann auch die jeweils entgegengesetzte 
Methode genutzt werden, sprich, LocalDate.now().minusMonths(1) kommt zum gleichen 
Ergebnis wie LocalDate.now().plusMonths(-1). Die with* (..)-Methoden belegen ein Feld neu 
und liefern ein modifiziertes neues LocalDate-Objekt. 


Von einem LocaleDate lassen sich andere temporale Objekte bilden; atTime(..) etwa liefert 
LocalDateTime-Objekte, bei denen gewisse Zeitfelder belegt sind. atTime(int hour, int minute) 
ist so ein Beispiel. Mit until (..) lässt sich eine Zeitdauer vom Typ Period liefern. Interessant 
sind zwei Methoden, die einen Strom von LocalDate-Objekten bis zu einem Endpunkt liefern: 


>» Stream<LocalDate> datesUntil( LocalDate endExclusive ) 


>» Stream<LocalDate> datesUntil( LocalDate endExclusive, Period step ) 


16.9 Logging mit Java 


Das Loggen (Protokollieren) von Informationen über Programmzustände ist ein wichtiger 
Teil, um später den Ablauf und die Zustände von Programmen rekonstruieren und verstehen 
zu können. Mit einer Logging-API lassen sich Meldungen auf die Konsole oder in externe 
Speicher wie Text- bzw. XML-Dateien und Datenbanken schreiben oder über einen Chat ver- 
breiten. 


16.9.1 Logging-APls 


Bei den Logging-Bibliotheken und APIs ist die Java-Welt leider gespalten. Da die Java-Stan- 
dardbibliothek in den ersten Versionen keine Logging-API anbot, füllte die Open-Source- 
Bibliothek log4j schnell diese Lücke. Sie wird heute in nahezu jedem größeren Java-Projekt 
eingesetzt. Als in Java 1.4 die Logging-API (JSR 47) einzog, war die Java-Gemeinde erstaunt, 
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dass java.util.logging (JUL) weder API-kompatibel mit dem beliebten log4j noch so leis- 
tungsfähig wie log4j ist.? 

Im Laufe der Jahre veränderte sich das Bild. Während in der Anfangszeit Entwickler aus- 
schließlich auf log4j bauten, werden es langsam mehr Projekte mit der JUL. Ein erster Grund 
ist der, dass einige Entwickler externe Abhängigkeiten vermeiden wollen (wobei das nicht 
wirklich funktioniert, da nahezu jede eingebundene Java-Bibliothek selbst auf log4j baut). 
Der zweite Grund ist, dass für viele Projekte JUL einfach reicht. In der Praxis bedeutet dies für 
größere Projekte, dass mehrere Logging-Konfigurationen das eigene Programm verschmut- 
zen, da jede Logging-Implementierung unterschiedlich konfiguriert wird. 


16.9.2 Logging mit java.util.logging 


Mit der Java-Logging-APl lässt sich eine Meldung schreiben, die sich dann zur Wartung oder 
zur Sicherheitskontrolle einsetzen lässt. Die APl ist einfach: 


Listing 16.5 src/main/java/com/tutego/insel/logging/CULDemo.java, JULDemo 


package com.tutego.insel.logging; 


import static java.time.temporal.ChronoUnit.MILLIS; 
import static java.time.Instant.now; 

import java.time.Instant; 

import java.util.logging.Level; 

import java.util.logging.Logger; 


public class JULDemo { 
private static final Logger log = Logger.getLogger( JULDemo.class.getName() ); 


public static void main( String[] args ) { 
Instant start = now(); 
log.info( "Wir starten mit JUL" ); 


try { 
log.log( Level.INFO, "In {0} Sekunden geht es los", 0 ); 
throw null; // Fehler erzeugen 

} 

catch ( Exception e ) { 
log.log( Level.SEVERE, "Oh Oh", e ); 


9 Die Standard Logging-APl ist dagegen nur ein laues Lüftchen, das nur Grundlegendes wie hierarchische 
Logger bietet. An die Leistungsfähigkeit von log4j mit einer großen Anzahl von Schreibern in Dateien, Sys- 
log-/NT-Logger, Datenbanken, Versand über das Netzwerk kommt das Standard-Logging nicht heran. 
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log.info( () -> String. format( "Laufzeit %s ms", start.until( now(), MILLIS ) ) ); 


} 
} 


Lassen wir das Beispiel laufen, folgt auf der Konsole die Warnung: 


Mai 21, 2017 10:24:57 NACHM. com.tutego.insel.logging.JULDemo main 
INFORMATION: Wir starten mit JUL 
Mai 21, 10:24:57 NACHM. com.tutego.insel.logging.JULDemo main 
INFORMATION: In O Sekunden geht es los 
Mai 21, 10:24:57 NACHM. com.tutego.insel.logging.JULDemo main 
SCHWERWIEGEND: Oh Oh 
java.lang.NullPointerException 

at com.tutego.insel.logging. JULDemo.main(JULDemo.java:19) 


Mai 21, 2017 10:24:57 NACHM. com.tutego.insel.logging.JULDemo main 
INFORMATION: Laufzeit 131 ms 


Das Logger-Objekt 


Zentral ist das Logger-Objekt, das über Logger.getAnonymousLogger() oder über Logger.get- 
Logger (String name) geholt werden kann, wobei name in der Regel mit dem voll qualifizierten 
Klassennamen belegt ist. Oft ist der Logger als private statische finale Variable in der Klasse 
deklariert. 


Loggen mit Log-Level 
Nicht jede Meldung ist gleich wichtig. Einige sind für das Debuggen oder wegen der Zeitmes- 
sungen hilfreich, doch Ausnahmen in den catch-Zweigen sind enorm wichtig. Damit ver- 
schiedene Detailgrade unterstützt werden, lässt sich ein Log-Level festlegen. Er bestimmt, 
wie »ernst« der Fehler bzw. eine Meldung ist. Das ist später wichtig, wenn die Fehler nach 
ihrer Dringlichkeit aussortiert werden. Die Log-Level sind in der Klasse Level als Konstanten 
deklariert:!° 

FINEST (kleinste Stufe) 

FINER 

FINE 

CONFIG 

INFO 


10 Da das Logging-Framework in Version 1.4 zu Java stieß, nutzt es noch keine typisierten Aufzählungen, 
denn die gibt es erst seit Java 5. 
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» WARNING 
> SEVERE (höchste Stufe) 


Zum Loggen selbst bietet die Logger-Klasse die allgemeine Methode log(Level level, String 
msg) bzw. für jeden Level eine eigene Methode: 


Aufruf über log(...) spezielle Log-Methode 


SEVERE severe(Stringmsg) 
warning(Stringmsg) 
info(Stringmsg) 
config(Stringmsg) 
fine(Stringmsg) 
finer(Stringmsg) 
finest(Stringmsg) 


Tabelle 16.9 Log-Level und Methoden 


Alle diese Methoden setzen eine Mitteilung vom Typ String ab. Sollen eine Ausnahme und 
der dazugehörende Strack-Trace geloggt werden, müssen Entwickler zu folgender Logger- 
Methode greifen, die auch schon das Beispiel nutzt: 


m voidlog(Level level, String msg, Throwable thrown) 


Die Varianten von severe(..), warning(..) usw. sind nicht überladen mit einem Parametertyp 
Throwable. 


16.10 Maven: Build-Management und Abhängigkeiten auflösen 


Software zu bauen und die Abhängigkeiten der Module zu überwachen, ist eine Tätigkeit, die 
nicht manuell, sondern automatisch passieren sollte. Die freie und quelloffene Software 
Apache Maven hat sich hier als Quasistandard durchgesetzt. Maven lässt sich entweder von 
der Website https://maven.apache.org/ beziehen und als Werkzeug von der Kommandozeile 
aus nutzen oder schön integriert über die Entwicklungsumgebung. Alle wichtigen IDEs 
unterstützten Maven von Haus aus. 


Um Projekte zu beschreiben, nutzt Maven POM-Dateien (das Kürzel steht für Project Object 
Model). Sie enthalten die gesamte Konfiguration und Projektbeschreibung. Dazu zählen 
unter anderem: 
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Name und Kennung des Projekts 
Abhängigkeiten 
Compilereinstellungen 


Lizenz 


Eine POM-Datei heißt in der Regel pom.xml und liegt im Hauptverzeichnis einer Anwendung 
- die Dateiendung signalisiert, dass es sich um eine XML-Datei handelt. Ein Java-Compiler 
und die Werkzeuge müssen mit Maven nicht mehr von Hand aufgerufen werden, die ganze 
Steuerung liegt abschließend bei Maven. 


16.10.1 Beispielprojekt in Eclipse mit Maven 


Statt in Eclipse mit FILE + NEW » JAVA PROJECT ein Projekt aufzubauen, ist der Schritt mit 
Maven ein anderer. Das liegt unter anderem daran, dass Maven eine eigene Verzeichnis- 
struktur definiert, die Standard Directory Layout genannt wird. Sie unterscheidet sich von 
der Standardstruktur von Eclipse, die nur ein einfaches src- und bin-Verzeichnis vorsieht. 
Maven unterteilt Klassen, Testfälle, Ressourcen in diverse Unterverzeichnisse. 


In Eclipse öffnet FILE + NEW » OTHER einen Dialog, in dem unter MAVEN der Punkt MAVEN 
PROJECT erscheint. Aktivieren wir CREATE A SIMPLE PROJECT und navigieren wir zum nächs- 
ten Dialog, lassen sich die zentralen Projekteigenschaften einstellen, die sich Koordinaten 
nennen. Wir wählen für ein Beispiel: 


> GROUP ID: com.tutego.webapp: Die Gruppierungsbezeichnung ist mit dem Paketnamen 
vergleichbar. Sie repräsentiert das Unternehmen. 
> ARTIFACT ID: tutego-webapp: der Name des Artefakts, also das Produkt, das gebaut wird 


> NAME: new-tutego-webapp 


Mit FINISH schließen wir ab. Im Package Explorer sieht die Ordnerstruktur anders aus als 
üblich, mit vier Codeordnern src/main/java, src/main/resources, src/main/test und src/test/ 
resources. Neu ist auch ein Ordner target; einen versteckten bin-Ordner gibt es nicht mehr. 


Beim Öffnen der pom.xml nutzt Eclipse einen eigenen Editor und unterschiedliche Reiter 
(OVERVIEW, DEPENDENCIES ...) für verschiedene Aspekte der Konfigurationsdatei. Unter 
POM.XML lässt sich die XML-Datei direkt bearbeiten, wenn die bereitgestellten Editoren 
besondere Einstellungen nicht zulassen. 


16.10.2 Properties hinzunehmen 


Als Erstes wollen wir den Java-Compiler auf Version 17 hochsetzen. Dazu falten wir im Reiter 
OVERVIEW den Bereich PROPERTIES aus und klicken auf CREATE... um zwei Eigenschaften 
hinzuzufügen, die je aus NAME und VALUE bestehen: 
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> maven.compiler.target auf11 


> maven.compiler.source auf11 


Wechseln wir in die XML-Ansicht, hat Eclipse es so umgesetzt: 


<properties> 
<maven.compiler.target>17</maven.compiler.target> 
<maven.compiler.source>17</maven.compiler.source> 
</properties> 


Wir wollen von Hand eine weitere Eigenschaft in das Element properties einfügen, und zwar 
für die Encodierung, die immer UTF-8 sein soll: 


<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 


Zwar nutzt Maven nun den Java 17-Compiler und sieht alle Dateien als UTF-8-encodiert an, 
doch Eclipse bekommt davon nichts mit. Wir müssen Eclipse daher befehlen, aus der POM 
Informationen auszulesen und in die Projekteigenschaften zu übertragen. Daher gehen wir 
links auf den PACKAGE EXPLORER und aktivieren im Kontextmenü MAVEN » UPDATE PRO- 
JECT .... Danach steht bei den Projekten JRE SYSTEM LIBRARY [JAVASE-17]. 


16.10.3 Dependency hinzunehmen 


Wir wollen als Beispiel eine Abhängigkeit zu dem kleinen Web-Framework Spark (https:// 
sparkjava.com) herstellen. Wir wechseln im POM-Editor auf den Reiter DEPENDENCIES und 
klicken auf die Schaltfläche ADD. In das Textfeld GROUP ID tragen wir »com.sparkjava« ein, 
in ARTIFACT ID »spark-core«, und bei VERSION setzen wir »2.8.0« hinein. 


Die POM-Datei sieht nach dem Hinzufügen der Abhängigkeit so aus: 


Listing 16.6 pom.xml 


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemalocation="http://maven.apache.org/POM/4.0.0 es 
http://maven.apache.org/xsd/maven-4.0.0.x5d"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.tutego.webapp</groupId> 
<artifactId>tutego-webapp</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<name>new-tutego-webapp</name> 
<properties> 
<maven.compiler.target>17</maven.compiler.target> 
<maven.compiler.source>17</maven.compiler.source> 
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
</properties> 
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<dependencies> 
<dependency> 
<groupId>com.sparkjava</groupld> 
<artifactId>spark-core</artifactId> 
<version>2.9.3</version> 
</dependency> 
</dependencies> 
</project> 


Tipp [+] 


Die besondere Stärke von Maven liegt im Auflösen transitiver Abhängigkeiten. Welche JAR- 
Dateien und Abhängigkeiten Spark nach sich zieht, zeigt der Reiter DEPENDENCY HIERARCHY. 


Alles ist vorbereitet, Zeit für das Hauptprogramm: 


Listing 16.7 src/main/java/SparkServer.java 
public class SparkServer { 


public static void main( String[] args ) { 
spark.Spark.get( "/hello", ( req, res ) -> "Hallo Browser 


} 
} 


Starten wir das Programm wie üblich mit RUN AS » JAVA APPLICATION, startet ein Webserver, 
und unter der URL http://localhost:4567/hello können wir die Ausgabe ablesen. (Die Logger- 
Ausgaben können wir ignorieren.) Über Run As liegen auch weitere Menüpunkte, die uns 
direkt in gewisse Stellen des Lebenszyklus eines Maven-Builds hineinspringen lassen. 


+ req.userAgent() ); 


Über das Terminal-Icon lässt sich die spezielle Maven-Console öffnen, die Mavens Konsolen- 
ausgabe zeigt. 


16.10.4 Lokales und das Remote-Repository 


Das Auflösen der abhängigen Java-Archive dauert beim ersten Mal länger, da Maven ein 
Remote Repository kontaktiert und von dort immer die neusten JAR-Dateien bezieht und 
lokal ablegt. Das umfangreiche Remote Repository speichert zu vielen bekannten quelloffe- 
nen Projekten fast alle Versionen von JAR-Dateien. Das Central Repository hat die URL https:// 
repo.maven.apache.org/maven2/. 


Unter WINDOW + SHOW VIEW » OTHER ... * MAVEN » MAVEN REPOSITORIES zeigt Eclipse alle 
eingebundenen Repositories an. 


In Eclipses PACKAGE EXPLORER lassen sich unter dem Projekt bei MAVEN DEPENDENCIES 
mehrere JAR-Dateien ablesen. Gespeichert werden sie selbst nicht im Projekt, sondern in 
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einem lokalen Repository, das im Heimatverzeichnis des Anwenders liegt und .m2 heißt. Auf 
diese Weise teilen sich alle Maven-Projekte die gleichen JAR-Dateien, und diese müssen nicht 
projektweise immer neu bezogen und aktualisiert werden. 


16.10.5 Lebenszylus, Phasen und Maven-Plugins 


Ein Maven-Build besteht aus einem dreistufigen Lebenszyklus clean, default und site. Inner- 
halb dessen gibt es Phasen, zum Beispiel in default die Phase compile zum Übersetzen der 
Quellen. Alles, was Maven ausführt, sind Plugins, etwa compiler und viele andere, die https:// 
maven.apache.org/plugins/ auflistet. Ein Plugin kann unterschiedliche Goals ausführen. So 
kennt zum Beispiel das Javadoc-Plugin (beschrieben unter https://maven.apache.org/com- 
ponents/plugins/maven-javadoc-plugin/) aktuell 16 Goals. Ein Goal wird später über die Kom- 
mandozeile angesprochen oder über das RUN As-Kontextmenü auf der pom.xml in Eclipse. 


16.10.6 Archetypes 


Ein Maven-Archetype ist eine Vorlage für neue Projekte, sodass gleich diverse Klassen und 
Konfigurationen für einen schnellen Start generiert werden. Die Archetypen werden in 
einem Katalog gesammelt. 


In Eclipse lässt sich ein Katalog über WINDOWS » PROPERTIES • MAVEN + ARCHETYPES und 
ADD REMOTE CATALOG ... hinzufügen. Anschließend können wir in Eclipse wie am Anfang 
ein Maven-Projekt aufbauen, nur ist jetzt CREATE A SIMPLE PROJECT nicht zu aktivieren, son- 
dern wir müssen dazu mit NEXT auf die nächste Dialogseite wechseln. Jetzt lässt sich aus 
einer riesigen Liste ein Archetyp auswählen. 


16.11 Zum Weiterlesen 


Die Java-Bibliothek bietet zwar reichlich Klassen und Methoden, aber nicht immer das, was 
das aktuelle Projekt gerade benötigt. Die Lösung von Problemen, wie etwa Aufbau und Kon- 
figuration von Java-Projekten, objektrelationalen Mappern (https://www.hibernate.org) oder 
Kommandozeilenparsern, liegt in diversen kommerziellen oder quelloffenen Bibliotheken 
und Frameworks. Während bei eingekauften Produkten die Lizenzfrage offensichtlich ist, ist 
bei quelloffenen Produkten eine Integration in das eigene Closed-Source-Projekt nicht 
immer selbstverständlich. Diverse Lizenzformen (https://opensource.org/licenses) bei Open- 
Source-Software mit immer unterschiedlichen Vorgaben - Quellcode veränderbar, Derivate 
müssen frei sein, Vermischung mit proprietärer Software möglich - erschweren die Auswahl, 
und Verstöße (https://gpl-violations.org/) werden öffentlich angeprangert und sind unange- 
nehm. Java-Entwickler sollten für den kommerziellen Vertrieb ihr Augenmerk verstärkt auf 
Software unter der BSD-Lizenz (die Apache-Lizenz gehört in diese Gruppe) und unter der 
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LGPL-Lizenz richten. Die Apache-Gruppe hat mit den Apache Commons (http://commons. 
apache.org) eine hübsche Sammlung an Klassen und Methoden zusammengetragen, und 
das Studium der Quellen sollte für Softwareentwickler mehr zum Alltag gehören. Die Web- 
site https://www.openhub.net eignet sich dafür außerordentlich gut, da sie eine Suche über 
bestimmte Stichwörter durch mehr als 1 Milliarde Quellcodezeilen verschiedener Program- 
miersprachen ermöglicht; erstaunlich, wie viele Entwickler »F*ck« schreiben. Und »Porn 
Groove« kannte ich vor dieser Suche auch noch nicht. 
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Auf der Webseite zu diesem Buch stehen folgende Materialien für Sie zum Download bereit: 


> alle Beispielprogramme 


Gehen Sie auf www.rheinwerk-verlag.de/5432. Klicken Sie auf den Reiter MATERIALIEN. Sie 
sehen die herunterladbaren Dateien samt einer Kurzbeschreibung des Dateiinhalts. Klicken 
Sie auf den Button HERUNTERLADEN, um den Download zu starten. Je nach Größe der Datei 
(und Ihrer Internetverbindung) kann es einige Zeit dauern, bis der Download abgeschlossen 
ist. 


